カスタムStyleBookをインポートする

January 29, 2024

寄稿者:

StyleBook を作成したら、NetScaler コンソールにインポートして使用します。NetScaler Consoleでは、1つのStyleBook をYAML形式でインポートすることも、複数のStyleBook YAMLファイルを.zip、.tgz、または.gz形式のバンドルとしてインポートすることもできます。NetScalerコンソールシステムは、インポート時にStyleBook を検証します。これで、StyleBookを使用して構成を作成する準備ができました。

NetScaler Consoleには、StyleBook のYAMLコンテンツを作成するために使用できるYAMLエディターも組み込まれています。YAMLエディターを使用すると、NetScalerコンソールのGUI自体からYAMLコンストラクトを検証できます。これらの検証チェックに個別のツールを使用する必要はありません。コンテンツはYAML標準に照らして検証され、偏差が強調表示されます。その後、内容を修正して、StyleBook をNetScaler コンソールにインポートしてみてください。ビルトインのYAMLエディターには、独自のStyleBookを作成する際に2つの利点があります。

色分けされています。エディタには、YAMLガイドラインに従って解析されたStyleBookコンテンツが表示されます。色分けにより、YAML コンテンツで定義されているキーと値を簡単に区別できます。

YAML 検証です。入力時にコンテンツの YAML エラーが検証され、逸脱があればすぐに強調表示されます。この検証により、NetScaler ConsoleにStyleBookをインポートする前でも、YAMLガイドラインに準拠したテキストを書くことができます。

注:

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

StyleBookの説明とヘッダーにHTMLフォーマットタグを使用する

StyleBookの定義には 、ヘッダーフィールドを含めたり、テキストにHTMLフォーマットタグを使用したりできます。ヘッダーの一部として画像を含めることもできます。ヘッダーフィールドの HTML コンテンツは、構成を作成または更新するときに、構成ページの上部に表示されます。この機能により、StyleBookの構成を理解するのに役立つインフォグラフィックを追加できます。ヘッダーに画像を使用する場合は、 <img> タグに必ず base64 でエンコードされた画像形式を使用してください。

HTML コンテンツで画像を使用するには、次の例のように画像をインラインにする必要があります。オンラインツールを使用して、画像を base64 でエンコードされた形式に変換できます。

name: cs-example
namespace: com.example.stylebooks
version: "1.2"
display-name: Content Switching Configuration
description: Example of a very simple content switching config that creates and binds an lb to a cs
header:  <img id="b64img" src="data:image/png;base64,…" />
     <h3>Operations performed by this StyleBook:</h3>
     <ul>
      <li style="list-style-type: circle"> Creates a Server </li>
      <li style="list-style-type: circle"> Creates a Service Group </li>
       <li style="list-style-type: circle"> Creates a LBVServer </li>
      <li style="list-style-type: circle"> Creates a CS Policy and Action </li>
     </ul>
schema-version: "1.0"
<!--NeedCopy-->

StyleBookをインポートするには

NetScaler Consoleで、［アプリケーション］>［構成］>［ StyleBook］に移動し、［新しいStyleBook のインポート］をクリックします。

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

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

注：

この例では、 StyleBookでlb-vserver.yml作成したStyleBookをインポートして、負荷分散仮想サーバーを作成します。
バンドル-NetScalerコンソールでは、多数のStyleBook をYAML形式でインポートできます。zip（.zip）形式または tarball（.tgz、.gz）形式で圧縮された複数の YAML StyleBook ファイルをインポートできます。

NetScaler ConsoleにインポートされたStyleBook は、StyleBook の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 フォルダーには必要なアイコンがあります。

この例では、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のコンテンツを検証するには、「コンテンツを検証」をクリックします。
注意:

StyleBookを作成する際には、次の概念を必ず理解してください。
- NITRO API
- YAML
独自のStyleBookを作成する方法について詳しくは、「独自のStyleBookを作成する方法」を参照してください。

注:

お気に入りのエディターでStyleBookを作成し、コンテンツをコピーしてYAMLエディターに貼り付けて検証およびインポートすることもできます。
リポジトリの同期 -GitHubでStyleBook を作成および管理する場合、NetScaler Consoleでこのオプションを使用すると、リポジトリ内の新規または更新されたStyleBook を見つけることができます。NetScaler コンソールと同期するリポジトリを選択します。