カスタムStyleBookをインポートする
StyleBookを作成したら、それを使用するためにNetScaler Consoleにインポートする必要があります。NetScaler Consoleでは、単一のStyleBookをYAML形式で、または複数のStyleBook YAMLファイルを.zip、.tgz、または.gz形式のバンドルとしてインポートできます。NetScaler Consoleシステムは、インポート時にStyleBookを検証します。これで、StyleBookは構成の作成に使用できるようになります。
NetScaler Consoleには、StyleBookのYAMLコンテンツを作成するために使用できる組み込みのYAMLエディターも用意されています。YAMLエディターを使用すると、NetScaler Console GUIから直接YAML構造を検証できます。これらの検証チェックのために別のツールを使用する必要はありません。コンテンツはYAML標準に対して検証され、逸脱がある場合は強調表示されます。その後、コンテンツを修正し、StyleBookをNetScaler Consoleにインポートできます。組み込みのYAMLエディターは、独自のStyleBookを作成する際に2つの利点を提供します。
-
色分け。エディターはYAMLガイドラインに従って解析されたStyleBookコンテンツを表示し、色分けによりYAMLコンテンツで定義されているキーと値を簡単に区別できます。
-
YAML検証。入力中にYAMLエラーがないかコンテンツが検証され、逸脱がある場合はすぐに強調表示されます。この検証により、NetScaler ConsoleにStyleBookをインポートする前でも、YAMLガイドラインに準拠したテキストを作成できます。
注:
現在、エディターはYAMLガイドラインに従ってコンテンツを検証します。コードの正確性や入力ミスは検証しません。
StyleBookをインポートするには
-
NetScaler Consoleで、Applications > Configuration > StyleBooks の順に移動し、Import New StyleBook をクリックします。
-
StyleBookをインポートするには、次のいずれかのオプションをクリックします。
-
ファイル - ローカルストレージから必要なファイルまたはファイルのバンドルを選択します。注:この例では、StyleBook to Create a Load Balancing Virtual Server で作成した
lb-vserver.ymlStyleBook をインポートします。
-
バンドル - NetScaler Consoleでは、複数のStyleBookをYAML形式でインポートできます。zip (.zip) 形式またはtarball (.tgz、.gz) 形式で圧縮された複数のYAML StyleBookファイルをインポートできます。
バンドル内の各StyleBookにアイコンを含めることができるようになりました。PNG、GIF、またはJPEG形式のアイコンを含むリソースフォルダがあることを確認してください。アイコンファイル名がStyleBook名と一致する場合、アイコンは自動的にStyleBookにマッピングされます。そうでない場合は、次の手順を実行します。-
リソースフォルダに
icon_mapping.jsonファイルを追加します。 -
icon_mapping.jsonファイルでStyleBookとアイコンを次のようにマッピングします。<StyleBook file name> : <icon file name>
以下はStyleBookバンドルの例です。
resourcesフォルダには必要なアイコンが含まれています。
この例では、sharepoint.yamlファイルとskype.yamlファイルはそれぞれsharepoint.jpegとskype.pngに自動的にマッピングされます。exchange.yamlをexch.pngにマッピングするには、icon_mapping.jsonファイルで次のように指定します。{
"exchange.yaml":"exch.png"
}defaulticonエントリを指定すると、StyleBookは別のアイコンにマッピングされていない限り、デフォルトのアイコンにマッピングされます。defaulticon: <icon file name>Applications > StyleBooksで、インポートされたStyleBookはマッピングされたアイコンとともに表示されます。 -
-
Raw - YAMLエディタでStyleBookのコンテンツを作成します。StyleBookの文法エラーをチェックするために、StyleBookのコンテンツを検証できます。StyleBookのコンテンツを検証するには、Validate Contentsをクリックします。注:StyleBookを作成する際は、以下の概念を理解していることを確認してください。
-
NITRO API
-
YAML
独自のStyleBookの作成方法の詳細については、独自のStyleBookの作成方法を参照してください。
-
-
リポジトリの同期 - このオプションには、NetScaler Consoleに追加されたリポジトリが一覧表示されます。NetScaler Consoleと同期するリポジトリを選択します。
注:StyleBook YAMLファイルの内容をYAMLエディターにコピー＆ペーストすることもできます。 -
-
オプションで、StyleBookのアイコンを選択します。アプリケーション > StyleBookで、インポートされたStyleBookがこのアイコンとともに表示されます。
-
作成をクリックします。NetScaler Consoleは、StyleBookの文法に従って、すべての構文エラーと意味エラーについてStyleBookを検証します。エラーがある場合、StyleBookはNetScaler Consoleにインポートされません。エラーがない場合、StyleBookは正常にインポートされ、StyleBooksページに表示されます。StyleBookのヘッダーセクションで定義した表示名でStyleBookを識別できます。注:ファイルのバンドルをインポートする場合、NetScaler Consoleは圧縮されたフォルダーを解凍し、すべてのStyleBookを検証します。 StyleBookファイルのいずれか1つでも検証テストに失敗すると、バンドルはインポートされません。StyleBookの文法、およびさまざまな構成要素と属性の構文の詳細については、「StyleBookの文法」を参照してください。
-
このStyleBookから構成を作成するには、**［構成の作成］**リンクをクリックします。StyleBookは、このStyleBookで定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして開きます。
-
パラメーターに必要な値を指定します。次の例では、,
-
アプリケーション名とロードバランサーIPアドレスの必須フィールドを指定します。
-
リストからロードバランシングアルゴリズムを選択します。デフォルトでは、ROUNDROBINが選択されています。
-
-
**［ターゲットインスタンス］**で、構成を展開するNetScalerインスタンスのIPアドレスを選択します。必要な数のターゲットインスタンスを指定することで、複数のNetScalerに構成を展開することもできます。
-
構成を展開する前にNetScaler（NITRO）構成オブジェクトでテストする場合は、**［ドライラン］**をクリックします。構成が有効な場合、指定された値に基づいて構成オブジェクトが作成されます。この例では、StyleBookは
lbvserverタイプのオブジェクトを1つだけ作成します。このロードバランシングサーバーは、この基本的な例のStyleBookで定義された唯一のコンポーネントでした。その後、**［作成］**をクリックして、選択したNetScalerインスタンスに構成を展開します。
構成が正常に展開されると、新しい構成パックが**［構成］**ページに表示されます。
注：
更新アイコンをクリックして、NetScaler Consoleで最近検出されたNetScalerインスタンスをこのウィンドウの利用可能なインスタンスのリストに追加することもできます。
カスタムStyleBookを検索する
NetScaler Consoleでは、StyleBookをそのタイプに基づいて検索できるようになりました。つまり、デフォルトのStyleBookまたはカスタムStyleBookのいずれかを検索できます。このオプションは、多数のデフォルトStyleBookの中からユーザー定義のStyleBookを検索する必要がある場合に特に役立ちます。
カスタムStyleBookを検索するには
-
NetScaler Consoleで、Applications > Configurations > StyleBooks に移動します。
-
右上隅にある検索アイコンをクリックします。
-
検索バーで、Type を選択し、サブリストから Custom を選択します。
-
NetScaler Consoleには、ユーザー定義のStyleBookのみが表示されます。