カスタムStyleBookをインポートする
StyleBookを構築したら、それをNetScaler Application Delivery Management（ADM）にインポートして使用する必要があります。NetScaler ADM では、単一のStyleBookをYAML形式でインポートすることも、複数のStyleBookYAMLファイルを.zip、.tgz、または.gz形式でバンドルとしてインポートすることもできます。NetScaler ADM システムは、インポート時にStyleBookを検証します。これで、StyleBookを使用して構成を作成する準備ができました。
NetScaler ADM には、StyleBook YAMLコンテンツの作成に使用できる組み込みのYAMLエディタもあります。YAMLエディタを使用すると、NetScaler ADM GUI自体から YAML 構造を検証できます。これらの検証チェックに個別のツールを使用する必要はありません。コンテンツはYAML標準に照らして検証され、偏差が強調表示されます。その後、コンテンツを修正して、StyleBookをNetScaler ADM にインポートしてみることができます。ビルトインのYAMLエディターには、独自のStyleBookを作成する際に2つの利点があります。
- 色分けされています。エディタは、YAMLガイドラインに従って解析されたStyleBookコンテンツを表示し、色分けを使用すると、YAMLコンテンツで定義されているキーと値を簡単に区別するのに役立ちます。
- YAML 検証です。入力時にコンテンツが YAML エラーに対して検証され、偏差が即座に強調表示されます。この検証により、ADM に StyleBook をインポートする前でも、YAML ガイドラインに準拠したテキストを作成できます。
注:
現在、エディタは YAML ガイドラインに従ってコンテンツを検証します。コードの正確性と誤植は検証されません。
StyleBookをインポートするには
-
NetScaler ADM で、［ アプリケーション ］>［ 構成 ］>［ StyleBook］の順に選択し、［ 新しいStyleBookのインポート］をクリックします。
-
StyleBookをインポートするには、次のオプションのいずれかをクリックします。
-
ファイル -ローカルストレージから必要なファイルまたはファイルのバンドルを選択します。
注:
この例では、
lb-vserver.ymlStyleBook で作成した StyleBook をインポートして、負荷分散仮想サーバーを作成します。
-
バンドル -NetScaler ADM では、複数のStyleBookをYAML形式でインポートできます。zip（.zip）形式または tarball（.tgz、.gz）形式で圧縮された複数の YAML StyleBook ファイルをインポートできます。
バンドル内の各StyleBookにアイコンを追加できるようになりました。PNG、GIF、または JPEG 形式のアイコンを含むリソースフォルダがあることを確認します。アイコンファイル名がStyleBook名と一致する場合、アイコンは自動的にStyleBookにマッピングされます。それ以外の場合は、次の操作を行います。
-
リソースフォルダに
icon_mapping.jsonファイルを追加します。 -
icon_mapping.jsonファイル内の StyleBooks とアイコンを次のようにマップします。<StyleBook file name> : <icon file name> <!--NeedCopy-->
StyleBookバンドルの例を次に示します。
resourcesフォルダには、必要なアイコンが含まれています。
この例では、
sharepoint.yamlおよびskype.yamlファイルはそれぞれsharepoint.jpegおよびskype.pngに自動的にマップされます。exchange.yamlをexch.pngにマッピングするには、icon_mapping.jsonファイルに次のように指定します。{ "exchange.yaml":"exch.png" } <!--NeedCopy-->defaulticonエントリを指定すると、StyleBookは別のアイコンにマップされない限り、デフォルトのアイコンにマップされます。defaulticon: <icon file name> <!--NeedCopy-->「 アプリケーション」>「StyleBook」では、インポートされたStyleBookがマップされたアイコンとともに表示されます。
-
-
Raw -YAMLエディタでStyleBook のコンテンツを作成します。
StyleBookのコンテンツを検証して、StyleBookの文法エラーをチェックできます。StyleBookのコンテンツを検証するには、「 コンテンツを検証」をクリックします。
注:
StyleBookを作成する際には、次の概念を必ず理解してください。
- NITRO API
- YAML
独自のStyleBookを作成する方法について詳しくは、「 独自のStyleBookを作成する方法」を参照してください。
-
リポジトリを同期 -このオプションは、ADM に追加されたリポジトリを一覧表示します。ADM と同期するリポジトリを選択します。
注：
StyleBook YAMLファイルからYAMLエディタにコンテンツをコピーして貼り付けることもできます。
-
-
必要に応じて、StyleBookのアイコンを選択します。
アプリケーション／StyleBookでは、インポートされたStyleBookがこのアイコンとともに表示されます。
-
［作成］ をクリックします。
NetScaler ADM は、StyleBookの文法に従って、すべての構文エラーと意味エラーについてStyleBookを検証するようになりました。エラーが発生した場合、StyleBookはNetScaler ADM にインポートされません。
エラーがなければ、StyleBookは正常にインポートされ、 StyleBooksページに表示されます 。StyleBookのヘッダーセクションで定義した表示名でStyleBookを識別できます。
注:
ファイルのバンドルをインポートする場合、NetScaler ADM は圧縮されたフォルダーを解凍し、すべてのStyleBookを検証します。 1つのStyleBookファイルが検証テストに失敗しても、バンドルはインポートされません。
StyleBook の文法と、さまざまな構文と属性の構文について詳しくは、「 StyleBook 文法」を参照してください。
-
このStyleBookから構成を作成するには、「構成の作成」リンクをクリックします。
StyleBookがユーザーインターフェイスページとして開きます。ここで、このStyleBookで定義されているすべてのパラメーターに対して値を入力できます。
-
パラメータに必要な値を指定します。
次の例では、
-
アプリケーション名とロードバランサのIP アドレスの必須フィールドを指定します 。
-
リストから [ 負荷分散アルゴリズム ] を選択します。デフォルトでは ROUNDROBIN が選択されています。
-
-
［ ターゲットインスタンス］で、構成を展開するNetScaler ADCインスタンスのIPアドレスを選択します。
ターゲットインスタンスを必要な数だけ指定して、複数のNetScaler ADC で構成を展開することもできます。
-
構成を展開する前に、NetScaler（NITRO）構成オブジェクトをテストする場合は、［ ドライ実行］をクリックします。
構成が有効な場合、設定オブジェクトは指定された値に基づいて作成されます。
この例では、StyleBookはタイプ
lbvserverのオブジェクトを1つだけ作成します 。この負荷分散サーバーは、この基本的な例StyleBookで定義されている唯一のコンポーネントでした。その後、［ 作成 ］をクリックして、選択したNetScaler ADCインスタンスに構成を展開します。
構成を正常に展開すると、[構成] ページに新しい構成パックが表示されます 。
注
更新アイコンをクリックして、NetScaler ADMで最近検出されたNetScalerインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。
カスタムStyleBookの検索
NetScaler ADM では、StyleBookをタイプに基づいて検索できるようになりました。つまり、デフォルトのStyleBookまたはカスタムStyleBookのいずれかを検索できるようになりました。このオプションは、多数のデフォルトStyleBookの中からユーザー定義のStyleBookを検索する必要がある場合に特に便利です。
カスタムStyleBookを検索するには
-
NetScaler ADM で、［ アプリケーション ］>［ 構成 ］>［ StyleBook］に移動します。
-
右上にある検索アイコンをクリックします。
-
検索バーで、[ 種類 ] を選択し、サブリストから [ カスタム ] を選択します。
-
NetScaler ADM では、ユーザー定義のStyleBookのみが表示されます。