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 エラーに対して検証され、偏差が即座に強調表示されます。この検証により、Citrix ADMにStyleBookをインポートする前でも、YAMLガイドラインに準拠したテキストを作成できます。

注:

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

StyleBookをインポートするには

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

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

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

      注:

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

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

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

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

      バンドル内の各StyleBookにアイコンを追加できるようになりました。これを行うには、 アイコンとicon_mapping.jsonファイルをresourcesフォルダにアップロードします。アイコンファイル名とStyleBook名が一致する場合、アイコンは自動的にStyleBookにマッピングされます。それ以外の場合は、StyleBooksとアイコンをicon_mapping.jsonファイルに次のようにマップします。

       <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-->
      
    • Raw -YAMLエディタでスタイルブックのコンテンツを作成します。

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

      注:

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

      • NITRO API
      • YAML

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

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

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

      ADM でのリポジトリの同期

    注:

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

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

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

    StyleBookをアイコンでインポートする

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

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

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

    StyleBookの例

    注:

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

    StyleBook の文法および構文について詳しくは、「スタイルブックの文法」を参照してください。

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

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

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

    次の例では、

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

    1. リストからLoadBalancing Algorithmを選択します。デフォルトでは、 ROUNDROBIN が選択されています。

    ![設定の展開例] (/en-us/citrix-application-delivery-management-service/media/nmas-stylebooks-yaml-editor-4.png)

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

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

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

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

    この例では、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をインポートする