Citrix Application Delivery Management

カスタムStyleBookをインポートする

StyleBookを構築したら、それをCitrix Application Delivery Management(ADM)にインポートして使用する必要があります。Citrix ADM では、単一のスタイルブックをYAML形式でインポートすることも、複数のスタイルブックYAMLファイルを.zip、.tgz、または.gz形式でバンドルとしてインポートすることもできます。Citrix ADM システムは、インポート時にスタイルブックを検証します。これで、StyleBookを使用して構成を作成できるようになりました。

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

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

注:

現在、エディタは YAML ガイドラインに従ってコンテンツを検証します。コードの正確性と誤植は検証されません。

スタイルブックを読み込むには

  1. Citrix ADM で、[ アプリケーション ]>[ 構成 ]>[ スタイルブック]の順に選択し、[ 新しいスタイルブックのインポート]をクリックします。

  2. 次のいずれかのオプションをクリックして、StyleBookをインポートします。

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

      注:

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

      StyleBookファイルをインポートする

    • バンドル -Citrix ADM では、複数のスタイルブックをYAML形式でインポートできます。zip(.zip)形式または tarball(.tgz、.gz)形式で圧縮された複数の YAML StyleBook ファイルをインポートできます。

      StyleBookバンドルをインポートする

      バンドル内の各StyleBookにアイコンを追加できるようになりました。PNG、GIF、または JPEG 形式のアイコンを含むリソースフォルダがあることを確認します。アイコンファイル名がStyleBook名と一致する場合、アイコンは自動的にStyleBookにマッピングされます。それ以外の場合は、次の操作を行います。

      1. リソースフォルダにicon_mapping.jsonファイルを追加します。

      2. icon_mapping.json ファイル内の StyleBooks とアイコンを次のようにマップします。

        <StyleBook file name> : <icon file name>
        <!--NeedCopy-->
        

      StyleBookバンドルの例を次に示します。

      StyleBookバンドル (アイコン付き)

      resources フォルダには、必要なアイコンが含まれています。

      リソースフォルダ内のアイコン

      この例では、sharepoint.yamlおよびskype.yamlファイルはそれぞれsharepoint.jpegおよびskype.pngに自動的にマップされます。

      exchange.yamlexch.pngにマッピングするには、 icon_mapping.json ファイルに次のように指定します。

       {
       "exchange.yaml":"exch.png"
       }
       <!--NeedCopy-->
      

      defaulticon エントリを指定すると、StyleBookは別のアイコンにマップされない限り、デフォルトのアイコンにマップされます。

       defaulticon: <icon file name>
       <!--NeedCopy-->
      

      アプリケーション/StyleBooksでは、インポートされたStyleBookがマップされたアイコンとともに表示されます。

    • Raw -YAMLエディタでスタイルブックのコンテンツを作成します。

      StyleBookの内容を検証して、StyleBookの文法エラーをチェックできます。StyleBookの内容を検証するには、「 内容を検証」をクリックします。

      注:

      StyleBookを作成する際には、次の概念を確認してください。

      • NITRO API
      • YAML

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

      ADM YAML エディタを使用してStyleBookをオーサリングする

    • リポジトリを同期 -このオプションは、ADM に追加されたリポジトリを一覧表示します。ADM と同期するリポジトリを選択します。

      ADM でのリポジトリの同期

    注:

    StyleBook YAMLファイルからYAMLエディタにコンテンツをコピーして貼り付けることもできます。

  3. 必要に応じて、StyleBookのアイコンを選択します。

    アプリケーション/StyleBookでは、インポートしたStyleBookがこのアイコンとともに表示されます。

    アイコン付きのスタイルブックを読み込む

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

    Citrix ADM は、StyleBookの文法に従って、すべての構文エラーと意味エラーについてStyleBookを検証するようになりました。エラーが発生した場合、StyleBookはCitrix ADM にインポートされません。

    エラーがなければ、StyleBookは正常にインポートされ、 StyleBook ページにリストされます。StyleBookのヘッダーセクションで定義した表示名でStyleBookを識別できます。

    スタイルブックの例

    注:

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

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

  5. このStyleBookから構成を作成するには、「構成の作成」リンクをクリックします。

    StyleBookがユーザーインターフェイスページとして開きます。ここで、このStyleBookで定義されているすべてのパラメーターに対して値を入力できます。

  6. パラメータに必要な値を指定します。

    次の例では、

    1. アプリケーション名とロードバランサのIP アドレスの必須フィールドを指定します

    2. リストから [ 負荷分散アルゴリズム ] を選択します。デフォルトでは ROUNDROBIN が選択されています。

      構成デプロイの例

  7. ターゲットインスタンス]で、構成を展開するCitrix ADCインスタンスのIPアドレスを選択します。

    ターゲットインスタンスを必要な数だけ指定して、複数のCitrix ADC で構成を展開することもできます。

  8. 構成を展開する前に、Citrix ADC(NITRO)構成オブジェクトをテストする場合は、[ Dry Run]をクリックします。

    設定が有効な場合、設定オブジェクトは指定された値に基づいて作成されます。

    この例では、StyleBookはタイプlbvserverのオブジェクトを 1 つだけ作成します。この負荷分散サーバーは、この基本的な例StyleBookで定義されている唯一のコンポーネントでした。

    後で、[ 作成 ]をクリックして、選択したCitrix ADC インスタンスに構成を展開します。

構成を正常に展開すると、新しい構成パックが [ 構成 ] ページに表示されます。

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

新しい構成パック

カスタムスタイルブックの検索

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

カスタムスタイルブックを検索するには

  1. Citrix ADM で、[ アプリケーション ]>[ 構成 ]>[ スタイルブック]に移動します。

  2. 右上にある検索アイコンをクリックします。

  3. 検索バーで、[ タイプ ] を選択し、サブリストから [ カスタム ] を選択します。

  4. Citrix ADM では、ユーザー定義のスタイルブックのみが表示されます。

カスタムスタイルブックの検索

カスタムStyleBookをインポートする