Application Delivery Management

カスタムStyleBookの作成と使用

デプロイ用に独自のStyleBookを作成し、NetScaler® Application Delivery Management (ADM)にインポートして、構成オブジェクトを作成できます。APIを使用してStyleBookから構成を作成することもできます。

本ドキュメントには以下の情報が含まれています。

開始する前に

StyleBookの作成を開始する前に、以下の知識があることを確認してください。

StyleBookファイルはYAML形式を使用します。YAML形式の詳細については、YAML構文を参照してください。

StyleBookの作成時に注意すべきYAMLガイドラインのリストを以下に示します。

  • YAMLは大文字と小文字を区別します。
  • YAMLは適切なインデントを必要とします。
  • <spacebar>キーを使用して適切なインデントを作成します。<tab>キーは使用しないでください。<tab>キーを使用すると、StyleBookをMAサービスにインポートする際にコンパイルエラーが発生します。
  • 文字列を引用符で囲まないでください。文字列に句読点(ダッシュ、コロンなど)が含まれている場合にのみ、文字列を引用符で囲んでください。数値を文字列として解釈したい場合は、数値を引用符で囲むか、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”
    • “No”
    • “True”
    • “False” など。

StyleBookファイルをNetScaler ADMにインポートする前に、ファイルがYAML形式に準拠していることを検証することをお勧めします。Citrixは、StyleBookに組み込まれているYAMLバリデーターを使用してYAMLコンテンツを検証およびインポートすることを推奨します。

StyleBookを構成する際、作成および削除操作(POSTおよびDELETE HTTPメソッド)をサポートするNitro構成リソースのみを使用できます。詳細については、Nitro APIドキュメントを参照してください。

StyleBookの構造

StyleBookを作成するには、StyleBookの文法、構文、および構造を理解する必要があります。標準的なStyleBookには、以下のセクションがあります。

  • ヘッダー: このセクションでは、StyleBookのIDを定義し、その機能について説明します。これは必須セクションです。
  • StyleBookのインポート: このセクションでは、現在のStyleBookから参照したい他のStyleBookを宣言できます。StyleBookを作成するには、NetScaler NITRO構成StyleBookまたは他のStyleBookをインポートする必要があります。これは必須セクションです。
  • パラメーター: このセクションでは、構成を作成するためにStyleBookで必要となるパラメーターを定義できます。StyleBookが受け取る入力を記述します。これはオプションのセクションです。
  • コンポーネント: このセクションでは、特定の構成のためにStyleBookによって作成されるエンティティ(構成オブジェクト)を定義できます。このセクションはStyleBookの核と見なされます。コンポーネントは通常、パラメーターセクションで提供された入力を使用して、StyleBookによって生成される構成を調整します。これはオプションのセクションです。

    StyleBookには、パラメーターセクション、コンポーネントセクション、またはその両方を含めることができます。パラメーターセクションのみを持つStyleBookは、他のStyleBookで使用できるパラメーターのリストを定義するのに役立ちます。これにより、一連のStyleBook間でパラメーターグループの再利用性が促進されます。コンポーネントセクションのみを持つStyleBookは、ユーザー入力を受け取るパラメーターを定義する代わりに、StyleBook内の属性の値を指定したい場合に使用できます。

  • 出力: パラメーターセクションがStyleBookの入力を定義する一方で、このオプションのセクションは出力を定義します。このオプションの出力セクションでは、このStyleBookから構成を作成するユーザーや、このStyleBookをインポートする他のStyleBookに公開したいコンポーネントを指定できます。ユーザーおよびインポートするStyleBookは、公開されたコンポーネントのプロパティを参照できます。
  • 操作: StyleBookには、StyleBookの一部である仮想サーバーでNetScaler ADMのAnalyticsを有効にするためのオプションセクションを含めることができます。

次の図は、StyleBookの簡単な概要を示しています。

ローカライズされた画像

次の例は、StyleBookの文法と構造、および複雑さが増すStyleBookの作成方法を学ぶのに役立ちます。

カスタムStyleBookの作成と使用