カスタムStyleBookの作成と使用

最終公開日 : Sep 25, 2026
展開用の独自のStyleBookを作成し、NetScaler Consoleにインポートして、構成オブジェクトを作成できます。APIを使用して、StyleBookから構成を作成することもできます。
このドキュメントには、次の情報が含まれています。
Related information
StyleBooks
ロードバランシング仮想サーバーを作成するためのStyleBook基本的なロードバランシング構成を作成するためのStyleBook複合StyleBookを作成するカスタムStyleBookでGUI属性を使用するカスタムStyleBookのインポート構成パックの作成と編集NetScaler ConsoleにファイルをアップロードするためのStyleBookを作成するNetScaler ConsoleにSSL証明書と証明書キーファイルをアップロードするためのStyleBookを作成するStyleBookを使用して証明書ストアからSSL証明書を管理するStyleBookで定義された仮想サーバーでアナリティクスを有効にし、アラームを設定するインスタンスの役割非CRUD操作を実行するStyleBookの作成StyleBookのconfig packを別のStyleBookに移行する

開始する前に

StyleBookの作成を開始する前に、次の知識があることを確認してください。
StyleBookファイルはYAML形式を使用します。YAML形式の詳細については、YAML Syntaxを参照してください。
StyleBookを作成する際に注意すべきYAMLガイドラインを以下に示します。
  • YAMLは大文字と小文字を区別します。
  • YAMLには適切なインデントが必要です。
  • 適切なインデントを作成するには、<spacebar>キーを使用します。<tab>キーは使用しないでください。<tab>キーを使用すると、StyleBookをMA Serviceにインポートする際にコンパイルエラーが発生します。
  • 文字列を引用符で囲まないでください。文字列に句読点（ダッシュ、コロンなど）が含まれている場合にのみ、文字列を引用符で囲んでください。数値を文字列として解釈したい場合は、数値を引用符で囲むか、StyleBookのstr()組み込み関数を使用してください。
  • YES/Yes/yes/Y/y/NO/no/No/n/N、ON/On/on/OFF/Off/off、TRUE/true/truthy/FALSE/False/false/falselyのようなリテラルはブール値と見なされ、それぞれtrueとfalseに相当します。これらを文字列として解釈するには、引用符で囲んでください。例：
    • "YES"
    • "いいえ"
    • "真"
    • "偽" など。
注
NetScaler ConsoleにStyleBookファイルをインポートする前に、ファイルがYAML形式に準拠していることを検証することをお勧めします。YAMLコンテンツを検証およびインポートするには、StyleBooksの組み込みYAMLバリデーターを使用することをお勧めします。
StyleBooksを構成する際、作成および削除操作 (POSTおよびDELETE HTTPメソッド) をサポートするNitro構成リソースのみを使用できます。詳細については、Nitro APIドキュメントを参照してください。

StyleBookの構造

StyleBooksを作成するには、StyleBooksの文法、構文、および構造を理解する必要があります。標準的なStyleBookには、次のセクションがあります。
  • ヘッダー: このセクションでは、StyleBookのIDを定義し、その機能について説明します。これは必須セクションです。
  • StyleBooksのインポート: このセクションでは、現在のStyleBookから参照する他のStyleBookを宣言できます。StyleBookを作成するには、NetScaler NITRO構成StyleBooksまたは他のStyleBooksをインポートする必要があります。これは必須セクションです。
  • パラメーター: このセクションでは、構成を作成するためにStyleBookで必要となるパラメーターを定義できます。StyleBookが受け取る入力を記述します。これはオプションのセクションです。
  • コンポーネント: このセクションでは、特定の構成のためにStyleBookによって作成されるエンティティ (構成オブジェクト) を定義できます。このセクションはStyleBookのコアと見なされます。コンポーネントは通常、パラメーターセクションで提供される入力を使用して、StyleBookによって生成される構成を調整します。これはオプションのセクションです。
    StyleBookには、パラメーターセクション、コンポーネントセクション、またはその両方を含めることができます。パラメーターセクションのみを持つStyleBookは、他のStyleBookで使用できるパラメーターのリストを定義するのに役立ちます。これにより、一連のStyleBook間でパラメーターグループの再利用が促進されます。コンポーネントセクションのみを持つStyleBookは、ユーザー入力を受け取るパラメーターを定義する代わりに、StyleBook内の属性の値を指定する場合に使用できます。
  • 出力: パラメーターセクションがStyleBookの入力を定義するのに対し、このオプションのセクションはその出力を定義します。このオプションの出力セクションでは、このStyleBookから構成を作成するユーザー、およびこのStyleBookをインポートする他のStyleBookに公開するコンポーネントを指定できます。ユーザーおよびインポートするStyleBookは、公開されたコンポーネントのプロパティを参照できます。
  • 操作: StyleBookには、StyleBookの一部である任意の仮想サーバーでNetScaler ConsoleのAnalyticsを有効にするためのオプションのセクションを含めることができます。
以下の図は、StyleBookの簡単な概要を示しています。
ローカライズされた画像(/en-us/netscaler-application-delivery-management-software/media/stylebook-outline.png)
以下の例は、StyleBookの文法と構造、および複雑さのレベルを上げてStyleBookを作成する方法を学ぶのに役立ちます。