Application Delivery Management

カスタムStyleBookを使用する

StyleBookを作成したら、NetScaler ADM にインポートして使用する必要があります。NetScaler ADM では、単一のStyleBookをYAML形式でインポートすることも、複数のStyleBookYAMLファイルを.zip、.tgz、または.gz形式でバンドルとしてインポートすることもできます。NetScaler ADM システムは、インポート時にStyleBookを検証します。これで、Stylebookを使用して構成を作成する準備が整いました。

NetScaler ADM には、StyleBook YAMLコンテンツの作成に使用できる組み込みのYAMLエディタもあります。YAMLエディターを使用すると、Citrix ADM GUI自体からYAMLコンストラクトを検証できます。これらの検証チェックに個別のツールを使用する必要はありません。コンテンツはYAML標準に照らして検証され、偏差が強調表示されます。その後、コンテンツを修正して、StyleBookをNetScaler ADM にインポートしてみることができます。ビルトインのYAMLエディターには、独自のStyleBookを作成する際に2つの利点があります。

  • 色分けされています。エディターには、YAMLガイドラインに従って解析されたStyleBookコンテンツが表示されます。色分けにより、YAMLコンテンツで定義されているキーと値を簡単に区別できます。
  • YAML 検証です。入力時にコンテンツが YAML エラーに対して検証され、偏差が即座に強調表示されます。これにより、NetScaler ADM でStyleBookをインポートする前でも、YAMLガイドラインに準拠したテキストを作成できます。現在、エディターは YAML ガイドラインに従ってコンテンツを検証しています。コードの正確性と誤植は検証されません。

StyleBookのインポート

  1. Citrix ADM で、「アプリケーション」>「構成」  >  「StyleBook」に移動し 、「新しいStyleBookのインポート」をクリック します。

  2. StyleBookをインポートするには、3つのオプションのいずれかをクリックします。

    1. ファイル。ローカルストレージから必要なファイルまたはファイルのバンドルを選択します。

      :この例では、StyleBookで作成した「lb-vserver.yaml」StyleBookをインポート して、負荷分散仮想サーバーを作成します。

      ローカライズされた画像

    2. バンドル。NetScaler ADMでは、複数のStyleBookをYAML形式でインポートできます。zip (.zip) 形式または tarball (.tgz、.gz) 形式で圧縮された YAML StyleBookファイルを複数インポートできます。

      ローカライズされた画像

    3. 未加工。YAML エディターでStyleBookのコンテンツを作成します。

      StyleBookを作成する際は、次の知識があることを確認してください。

      • NITRO API
      • YAML

      独自のStyleBookを作成する方法について詳しくは、「 独自のStyleBookを作成する方法」を参照してください。

      ローカライズされた画像

    :StyleBook YAMLファイルからコンテンツをコピーして貼り付けて、コンテンツを検証することもできます。

  3. [Create] をクリックします。

    NetScaler ADM は、StyleBookの文法に従って、すべての構文エラーと意味エラーについてStyleBookを検証するようになりました。エラーが発生した場合、StyleBookはNetScaler ADM にインポートされません。エラーがなければ、StyleBookは正常にインポートされ、StyleBooksページに表示されるようになりました。StyleBookのヘッダーセクションで定義した表示名でStyleBookを識別できます。

    注:

    ファイルのバンドルをインポートする場合、NetScaler ADM は圧縮されたフォルダーを解凍し、すべてのStyleBookを検証します。 1つのStyleBookファイルが検証テストに失敗しても、バンドルはインポートされません。

    StyleBookの文法とさまざまな構成と属性の構文について詳しくは、「StyleBookの文法」を参照 してください。

  4. このStyleBookから構成を作成するには、「構成を作成」リンクをクリック します 。StyleBookがユーザーインターフェイスページとして開きます。ここで、このStyleBookで定義されているすべてのパラメーターに対して値を入力できます。

  5. パラメータに必要な値を指定します。以下の例では、アプリケーション名 と ロードバランサーの IP アドレスフィールドが必須フィールド として表示され 、ユーザー値を受け入れることができることがわかります。  LB アルゴリズムには選択できる値が 2 つしかなく、デフォルトで ROUNDROBIN が選択されています。

  6. ターゲットインスタンス] で、構成を実行するCitrix ADC インスタンスのIPアドレスをクリックして選択します。ターゲットインスタンスを必要な数だけ指定して、複数のNetScaler ADC で構成を展開することもできます。

実際に構成を作成する前に、Citrix ADC 上に作成されるCitrix ADC(Nitro)構成オブジェクトを確認したい場合は、「ドライラン」をクリック します。設定が有効な場合は、指定した値に基づいて作成される設定オブジェクトが表示されます。この例では、この例の StyleBook では lbvserver タイプのオブジェクトが 1 つだけ作成されます。この lbvserver は、この基本的なStyleBookのサンプルで定義されている唯一のコンポーネントでした。後で [作成 ] をクリック して、選択したCitrix ADC インスタンスに実際に構成を作成できます。

作成が完了すると、新しい ConfigPack が [構成] ページに一覧表示されます。

更新アイコンをクリックして、NetScaler ADMで最近検出されたNetScaler ADCインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。

カスタムStyleBookの検索

Citrix ADM では、タイプに基づいてStyleBookを検索できるようになりました。つまり、デフォルトのStyleBookまたはカスタムStyleBookのいずれかを検索できるようになりました。このオプションは、多数のデフォルトStyleBookの中からユーザー定義のStyleBookを検索する必要がある場合に特に役立ちます。

カスタムStyleBookを検索するには

  1. NetScaler ADM で、[ アプリケーション ]>[ 構成 ]>[ StyleBook]に移動します。
  2. 右上にある検索アイコンをクリックします。
  3. 表示される検索バーで、最初のリストから [ タイプ ] を選択し、次のオプションリストから [ カスタム ] を選択します。
  4. NetScaler ADM では、ユーザー定義のStyleBookのみが表示されます。
カスタムStyleBookを使用する