カスタムStyleBookのインポート

• 色分け。エディターは、YAMLガイドラインに従って解析されたStyleBookコンテンツを表示します。色分けにより、YAMLコンテンツで定義されているキーと値を簡単に区別できます。
• YAML検証。入力中にYAMLエラーが検証され、逸脱がある場合はすぐに強調表示されます。この検証により、StyleBookをNetScaler Consoleにインポートする前でも、YAMLガイドラインに準拠したテキストを記述できます。

StyleBookの説明とヘッダーでHTML書式設定タグを使用する

StyleBookをインポートするには

1. NetScaler Consoleで、Applications > Configuration > StyleBooksに移動し、Import New StyleBookをクリックします。
2. 次のいずれかのオプションをクリックして、StyleBookをインポートします。
   • File - ローカルストレージから必要なファイルまたはファイルのバンドルを選択します。
     注：
     この例では、StyleBook to Create a Load Balancing Virtual Serverで作成したlb-vserver.yml StyleBookをインポートします。
     
   • バンドル - NetScaler Consoleでは、YAML形式のStyleBookを多数インポートできます。zip (.zip) 形式またはtarball (.tgz、.gz) 形式で圧縮された複数のYAML StyleBookファイルをインポートできます。
     
     NetScaler ConsoleにインポートされたStyleBookは、StyleBooks GUIにデフォルトのアイコンで表示されます。これらのデフォルトアイコンは、独自の画像でカスタマイズできます。
     そのためには、次の手順を実行します。
     • StyleBook YAMLファイルがあるフォルダーの下に、resourcesという名前のフォルダーを作成します。
     • アイコンをresourcesフォルダーにアップロードします。
     注:
     resourcesフォルダーの名前を他の名前に変更することはできません。
     • アイコンファイルとそれに対応するStyleBookファイルの名前が同じ場合、アイコンはStyleBookに自動的にマッピングされます。
     • アイコンファイルとそれに対応するStyleBookファイル（例：exchange.yamlとexch.png）が一致しない場合は、resourcesフォルダーに「icon_mapping.json」という名前のJSONファイルを次のように作成します。
     <StyleBook file name> : <icon file name>
<StyleBook file1 name> : <icon file1 name>
<StyleBook file2 name> : <icon file2 name>
     以下はStyleBookバンドルの例です。
     
     resourcesフォルダーには必要なアイコンが含まれています。
     リソースフォルダー内のアイコン(/en-us/netscaler-console-service/media/stylebook-resources-folder.png)
     この例では、sharepoint.yamlファイルとskype.yamlファイルは、それぞれsharepoint.jpegとskype.pngに自動的にマッピングされます。
     exchange.yamlをexch.pngにマッピングするには、icon_mapping.jsonファイルで次のように指定します。
     {
"exchange.yaml":"exch.png"
}
     StyleBookバンドルにアイコンがない場合、デフォルトのアイコンが表示されます。
   • Raw - YAMLエディターでStyleBookのコンテンツを作成します。
     StyleBookのコンテンツを検証して、StyleBookの文法エラーを確認できます。StyleBookのコンテンツを検証するには、Validate Contentsをクリックします。
     注:
     StyleBookを作成する際は、以下の概念を理解していることを確認してください。
     • NITRO API
     • YAML
     独自のStyleBookの作成方法の詳細については、「How to Create Your Own StyleBooks」を参照してください。
     
     注:
     お気に入りのエディターでStyleBookを作成し、そのコンテンツをYAMLエディターにコピー＆ペーストして、検証およびインポートすることもできます。

   • Sync Repository - GitHubでStyleBookを作成および管理している場合は、このオプションを使用して、NetScaler Consoleがリポジトリ内の新規または更新されたStyleBookを検出できるようにします。NetScaler Consoleと同期するリポジトリを選択します。
3. オプション: StyleBookのアイコンを選択します。
   Applications > Configuration > StyleBooksで、インポートされたStyleBookがこのアイコンとともに表示されます。
4. Createをクリックします。
   NetScaler Consoleは、StyleBookの文法に従って、すべての構文エラーと意味エラーについてStyleBookを検証します。エラーがある場合、StyleBookはNetScaler Consoleにインポートされません。
   エラーがない場合、StyleBookは正常にインポートされ、StyleBooksページに表示されます。StyleBookのヘッダーセクションで定義した表示名でStyleBookを識別できます。
   注:
   ファイルのバンドルをインポートする場合、NetScaler Consoleは圧縮されたフォルダを解凍し、すべてのStyleBookを検証します。 1つのStyleBookファイルが検証テストに失敗した場合でも、バンドルはインポートされません。
   StyleBookの文法、およびさまざまな構成要素と属性の構文の詳細については、StyleBookの文法を参照してください。
5. Create Configurationリンクをクリックして、このStyleBookから構成を作成します。
   StyleBookページが開き、このStyleBookで定義されているすべてのパラメータの値を入力できます。
6. パラメータに必要な値を指定します。
   次の例では、,
   1. アプリケーション名とロードバランサーIPアドレスの必須フィールドを指定します。
   2. リストからLoadBalancing Algorithmを選択します。デフォルトでは、ROUNDROBINが選択されています。
7. Target Instancesで、構成をデプロイするNetScalerインスタンスのIPアドレスを選択します。
   構成を複数のNetScalerに展開することもできます。その際は、必要な数のターゲットインスタンスを指定します。
   注:
   NetScaler Consoleで最近検出されたすべてのNetScalerインスタンスをターゲットインスタンスに追加するには、StyleBooksページに移動し、ページの右側にある更新アイコンをクリックします。

8. 構成を展開する前にNetScaler (NITRO) 構成オブジェクトをテストする場合は、ドライランをクリックします。
   構成が有効な場合、指定された値に基づいて構成オブジェクトが作成されます。
   この例では、StyleBookはタイプlbvserverのオブジェクトを1つだけ作成します。このロードバランシングサーバーは、この基本的な例のStyleBookで定義された唯一のコンポーネントでした。
   後で、作成をクリックして、選択したNetScalerインスタンスに構成を展開します。