StyleBook を構築したら、それを NetScaler Application Delivery Management (ADM) にインポートして使用する必要があります。 NetScaler ADM を使用すると、単一の StyleBook を YAML 形式でインポートすることも、複数の StyleBook YAML ファイルを .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 ガイドラインに従ってコンテンツを検証します。 コードの正確性やタイプミスの検証は行いません。
NetScaler ADM で、 アプリケーション > 構成 > スタイルブックに移動し、 新しいスタイルブックのインポートをクリックします。
StyleBook をインポートするには、次のいずれかのオプションをクリックします。
注記
この例では、「負荷分散仮想サーバーを作成するためのスタイルブック 」で作成した
lb-vserver.ymlスタイルブックをインポートします。
- **バンドル** - NetScaler ADM を使用すると、複数の StyleBook を YAML 形式でインポートできます。 zip (.zip) 形式または tarball (.tgz、.gz) 形式で圧縮された複数の YAML スタイルブック ファイルをインポートできます。
バンドル内の各スタイルブックにアイコンを含めることができるようになりました。 PNG、GIF、または JPEG 形式のアイコンが含まれるリソース フォルダーがあることを確認します。 アイコン ファイル名が StyleBook 名と一致する場合、アイコンは自動的に StyleBook にマップされます。 それ以外の場合は、次の操作を実行します。
1. リソース フォルダーに `icon_mapping.json` ファイルを追加します。
2. `icon_mapping.json` ファイル内のスタイルブックとアイコンを次のようにマップします。
```yaml
<StyleBook file name> : <icon file name>
<!--NeedCopy--> ```
以下は StyleBook バンドルの例です。
`リソース` フォルダーには必要なアイコンが含まれています。
この例では、 `sharepoint.yaml` と `skype.yaml` ファイルは、それぞれ `sharepoint.jpeg` と `skype.png` に自動的にマップされます。
`exchange.yaml` を `exch.png`にマッピングするには、 `icon_mapping.json` ファイルで以下を指定します。
```json
{
"exchange.yaml":"exch.png" }
<!--NeedCopy--> ```
`defaulticon` エントリを指定すると、StyleBook は別のアイコンにマップされていない限り、デフォルトのアイコンにマップされます。
```yaml
デフォルトアイコン: <icon file name>
<!--NeedCopy--> ```
**アプリケーション > スタイルブック**では、インポートされたスタイルブックがマップされたアイコンとともに表示されます。
- **Raw** - YAML エディターで StyleBook のコンテンツを作成します。
StyleBook の内容を検証して、StyleBook の文法エラーをチェックできます。 StyleBook の内容を検証するには、[ **内容を検証**] をクリックします。 > **注記** > > StyleBook を作成するときは、次の概念を必ず理解しておいてください。 > > - ニトロAPI > - ヤムル
独自のスタイルブックを作成する方法の詳細については、「 [独自のスタイルブックを作成する方法](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/how-to-create-custom-stylebooks.html)」を参照してください。
- **リポジトリの同期** - このオプションは、ADM に追加されたリポジトリを一覧表示します。 ADM と同期するリポジトリを選択します。 > **注記** > > StyleBook YAML ファイルの内容をコピーして、YAML エディターに貼り付けることもできます。
オプションで、StyleBook のアイコンを選択します。
アプリケーション > スタイルブックでは、インポートされたスタイルブックがこのアイコンとともに表示されます。
作成をクリックします。
NetScaler ADM は、StyleBook の文法に従って、StyleBook のすべての構文エラーと意味エラーを検証するようになりました。 エラーがある場合、StyleBook は NetScaler ADM にインポートされません。
エラーがなければ、StyleBook は正常にインポートされ、 StyleBooks ページに表示されます。 StyleBook のヘッダー セクションで定義した表示名で StyleBook を識別できます。
注記
ファイルのバンドルをインポートする場合、NetScaler ADM は圧縮されたフォルダーを解凍し、すべての StyleBook を検証します。 1 つの StyleBook ファイルが検証テストに失敗しても、バンドルはインポートされません。
StyleBook の文法とさまざまな構成要素および属性の構文の詳細については、「 [StyleBook 文法](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/stylebooks-grammar.html)」を参照してください。
このスタイルブックから構成を作成するには、[ 構成の作成 ] リンクをクリックします。
StyleBook はユーザー インターフェイス ページとして開き、この StyleBook で定義されているすべてのパラメータの値を入力できます。
パラメータに必要な値を指定します。
次の例では、
必須フィールド アプリケーション名 および ロードバランサの IP アドレス を指定します。
リストから LoadBalancing Algorithm を選択します。 デフォルトでは、 ROUNDROBIN が選択されています。
ターゲットインスタンスの下で、構成を展開する NetScaler インスタンスの IP アドレスを選択します。
必要な数のターゲット インスタンスを指定して、複数の NetScaler に構成を展開することもできます。
構成を展開する前に NetScaler (NITRO) 構成オブジェクトをテストする場合は、 Dry Runをクリックします。
構成が有効な場合、指定された値に基づいて構成オブジェクトが作成されます。
この例では、StyleBook はタイプ lbvserverのオブジェクトを 1 つだけ作成します。 この負荷分散サーバーは、この基本的なサンプル StyleBook で定義された唯一のコンポーネントです。
後で、[ 作成 ] をクリックして、選択した NetScaler インスタンスに構成を展開します。
構成が正常に展開されると、新しい構成パックが 構成 ページに表示されます。
注記
また、更新アイコンをクリックして、NetScaler ADM で最近検出された NetScaler インスタンスをこのウィンドウの使用可能なインスタンスのリストに追加することもできます。
NetScaler ADM では、StyleBook をタイプに基づいて検索できるようになりました。 つまり、デフォルトのスタイルブックまたはカスタム スタイルブックのいずれかを検索できるようになりました。 このオプションは、多数のデフォルトのスタイルブックの中からユーザー定義のスタイルブックを検索する必要がある場合に特に役立ちます。
NetScaler ADM で、 アプリケーション > 構成 > スタイルブックに移動します。
右上にある検索アイコンをクリックします。
検索バーで、 タイプ を選択し、サブリストから カスタム を選択します。
NetScaler ADM には、ユーザー定義の StyleBook のみが表示されます。