StyleBookのカテゴリ
NetScaler Consoleには、デフォルトとカスタムの2つのStyleBookカテゴリがあります。これらはパブリックまたはプライベートのいずれかになります。NetScaler Consoleでは、システムに存在するすべてのStyleBookと、それらがどのように相互に接続されているかを表示できます。
このドキュメントでは、さまざまな種類のStyleBookと、NetScaler ConsoleからStyleBookに対して実行できる次のアクションについて説明します。
-
カスタムStyleBookをダウンロードして変更を加えるか、既存のStyleBookに基づいて新しいStyleBookを作成します。
-
NetScaler ConsoleのデフォルトStyleBookを非表示にします。
-
NetScaler ConsoleからカスタムStyleBookを削除します。
-
StyleBookにタグを追加します。
デフォルトStyleBookとカスタムStyleBook
-
デフォルトStyleBookは、NetScaler Consoleに付属しているStyleBookであり、NetScalerインスタンスに展開できる構成を作成できます。デフォルトStyleBookを削除することはできませんが、NetScaler Console GUIから非表示にすることはできます。
-
カスタムStyleBookは、NetScaler Consoleにインポートした独自のStyleBookです。
デフォルトStyleBookとカスタムStyleBookはどちらも、パブリックまたはプライベートのいずれかになります。
パブリックStyleBookとプライベートStyleBook
設定パックを作成できるStyleBookは、パブリックStyleBookとして分類できます。つまり、NetScaler Console GUIおよびAPIから構成を作成するために、すべて直接使用できます。
しかし、一部のStyleBookは、他のStyleBookの構成要素として使用されます。このようなStyleBookはプライベートとしてマークされます。プライベートStyleBookは、NetScaler Console GUIから設定パックを直接作成するために使用することはできません。ただし、これらのStyleBookをNetScaler Consoleに表示して確認することはできます。カスタムStyleBookのいずれかをプライベートとしてマークするには、StyleBookのプライベート属性をtrueに設定します。プライベートStyleBookは、NetScaler Console APIを使用して設定パックを作成するために引き続き使用できます。
プライベートとしてマークされたStyleBookの例
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true
StyleBookの表示
NetScaler Consoleでは、デフォルトとプライベートの両方のStyleBookの数が増加しています。アクセスしたい特定のStyleBookを検索したい場合があります。また、両方の種類のStyleBookを個別に表示したい場合もあります。
NetScaler Consoleで、Applications > Configuration > StyleBooks に移動すると、システムに存在するStyleBookのリストを表示できます。
デフォルトのパブリックStyleBookには、そのパネルに次のアイコンが表示されます。
デフォルトのパブリックStyleBook(/en-us/netscaler-console-service/media/mas-stylebooks-default-and-public-icon.png)
デフォルトのプライベートStyleBookには、それがプライベートStyleBookであることを示すアイコンが表示されます。
プライベートアイコン(/en-us/netscaler-console-service/media/mas-stylebooks-default-and-private-icon.png)
プライベートStyleBookの定義と依存関係を表示することはできますが、GUIを使用してプライベートStyleBookから設定パックを作成することはできません。プライベートStyleBookの主な目的は、別のStyleBookの構成要素として使用することです。構成要素となるStyleBookを使用することで、共通の設定パターンを再利用できます。
カスタムのパブリックStyleBookには、次の画像に示すように異なるアイコンが表示されます。
デフォルトのパブリックアイコン(/en-us/netscaler-console-service/media/mas-stylebooks-default-and-custom-icon.png)
カスタムのプライベートStyleBookには、このアイコンが表示されます。
デフォルトのプライベートアイコン(/en-us/netscaler-console-service/media/mas-stylebooks-private-and-custom-icon.png)
ページの右上には、表示するStyleBookの種類を選択するオプションがあります。オプションは「すべて」、「パブリック」、「プライベート」の3つです。いずれかのオプションをクリックします。
パブリックとプライベートでStyleBookをフィルタリング(/en-us/netscaler-console-service/media/nmas-stylebooks-sorting-icon-new.png)
検索アイコンをクリックして、特定のStyleBookを検索することもできます。名前、名前空間、バージョン属性、またはこれらのオプションの組み合わせで検索できます。検索操作では大文字と小文字は区別されません。
StyleBookを検索(/en-us/netscaler-console-service/media/nmas-stylebooks-searching-icon-new.png)
カスタムStyleBookをダウンロード
NetScaler ConsoleからカスタムStyleBookをダウンロードするには、Applications > Configuration > Confg Packsに移動します。右側のパネルに表示されるStyleBookのリストで、カスタム定義のStyleBookをダウンロードするオプションをチェックします。Downloadをクリックします。StyleBookに依存するカスタムStyleBookがある場合、ダウンロードされるバンドルに依存するStyleBookを含めることができます。
注
パブリックまたはプライベートとしてマークされているカスタムStyleBookをダウンロードできます。
StyleBookをダウンロード(/en-us/netscaler-console-service/media/mas-download-custom-stylebooks-new.png)
注
NetScaler ConsoleのデフォルトStyleBookはダウンロードできません。その定義と依存関係を表示できます。そのためには、StyleBookパネルのView DefinitionおよびView Dependenciesリンクをクリックします。
カスタムStyleBookを更新
NetScaler Console GUIからカスタムStyleBookの定義を更新できます。そのため、バージョンを変更せずにStyleBookを変更できます。StyleBookバンドルからインポートされた定義を更新することもできます。
重要
NetScaler Console GUIからStyleBook定義を更新する前に、StyleBook定義に依存するStyleBookがないことを確認してください。
設定パックを持つStyleBook定義を更新できます。StyleBook定義が下位互換性があることを確認してください。そのため、すべてのパラメータは更新されたStyleBookに保持され、新しく追加されたパラメータはオプションとして表示されます。
-
Applications > Configuration > StyleBooksに移動します。
-
Custom StyleBooksタブを選択します。
-
更新するStyleBookで定義を更新を選択します。
-
必要に応じて定義を更新し、更新をクリックします。
-
ページを更新して、最新の変更を確認します。
カスタムStyleBookを削除する
削除ボタンをクリックして、カスタムStyleBookを削除することもできます。ポップアップウィンドウが表示され、NetScaler ConsoleからStyleBookを削除するかどうかを確認するメッセージが表示されます。StyleBookが他のカスタムStyleBookを使用している場合は、チェックボックスをオンにして、それらのStyleBookを削除することを選択できます。
注：
NetScaler Consoleに依存するStyleBookがある場合は、カスタムStyleBookを削除しないでください。この操作により、既存のStyleBookが破損する可能性があります。
StyleBookの依存関係を表示する
StyleBookの重要かつ強力な機能の1つは、他のStyleBookの構成要素として使用できることです。
次のことができます。
-
StyleBookを別のStyleBookにインポートする - インポートされたStyleBookはタイプとして宣言され、2番目のStyleBookのコンポーネントまたはパラメータによって使用されます。NetScaler Consoleの既存のデフォルトStyleBookを表示して、StyleBookが別のStyleBookの上にどのように構築できるかを確認してください。
-
StyleBookが相互にどのように接続されているかをグラフィカルに表示する - この表現は、他のStyleBookを構成要素として使用して構築された複雑なStyleBookに役立ちます。依存関係グラフを使用すると、StyleBook間の関係と依存関係を確認できます。
注：
他のStyleBookで使用されているStyleBookは、既存のStyleBookを破損させる可能性があるため、削除できません。依存関係グラフ表示を使用して、どのStyleBookがStyleBookの削除を妨げているかを特定します。
StyleBookの依存関係を表示するには
NetScaler Consoleで、Applications > Configuration > StyleBooks に移動します。StyleBooksページには、NetScaler Consoleで使用できるすべてのStyleBookが表示されます。下にスクロールして目的のStyleBookを見つけます。View Dependencies をクリックして、依存するStyleBookを表示します。
順方向の依存関係
Forward Dependencies タブでは、お使いのStyleBookが使用しているさまざまなデフォルトのStyleBookを表示できます。矢印をたどって、StyleBookが使用しているStyleBookを見つけます。いずれかの矢印にマウスを合わせると、その矢印と相互に接続されているStyleBookが強調表示されます。StyleBookをクリックして、そのStyleBookの定義を表示することもできます。
順方向の依存関係(/en-us/netscaler-console-service/media/nmas-stylebooks-forward-dependencies.png)
逆方向の依存関係
Reverse Dependencies タブでは、お使いのStyleBookを使用しているStyleBookをグラフィカルに表示できます。矢印をたどると、表示されているすべてのStyleBookがお使いのStyleBookを指していることがわかります。一部のStyleBookはStyleBookを直接使用している場合があり、一部のStyleBookは別のStyleBookを介してStyleBookを使用している場合があります。
逆方向の依存関係(/en-us/netscaler-console-service/media/nmas-stylebooks-reverse-dependencies.png)
設定パックに対するNetScaler構成の監査
StyleBook設定パックによって行われた変更を現在のNetScaler構成と比較できます。この比較により、次のことができます。
-
StyleBook設定パックとNetScaler構成間の設定ドリフトを検出します。
-
設定パックによって行われた変更が表示されない、NetScaler上の変更済みおよび削除済みオブジェクトを特定します。
設定パックの変更をNetScalerインスタンス構成と比較するには、次の手順を実行します。
注記：
NetScalerインスタンスに展開されているStyleBook構成パックを更新する際、展開された状態と異なる場合があります。その場合、構成パックの更新は失敗します。StyleBookエンジンは、これらの差異を自動的に調整し、構成パックを更新します。
構成パックのサポートバンドルをダウンロードする
構成パックのサポートバンドルは、Citrixテクニカルサポートチームが構成パックの問題を表示、分析、トラブルシューティングするのに役立ちます。サポートバンドルをダウンロードするには、次の手順を実行します。
StyleBookのタグを作成する
NetScaler Consoleの任意のStyleBookにタグを追加できます。タグは、さまざまな基準を使用してStyleBookをグループ化できるキーと値のペアです。NetScaler ConsoleでStyleBookを検索またはフィルタリングする際に、これらのタグを使用できます。
StyleBookにタグを追加するには：
-
Applications > Configuration > StyleBooksに移動します。
-
タグを追加したいStyleBookで、Tagsを選択します。StyleBookのタグ(/en-us/netscaler-console-service/media/adm-tags-stylebooks-new.png)すべての種類のStyleBookにタグを追加できます。
-
StyleBookのフィルタリングに役立つ、必要なKeyとValue情報を指定します。例：キー=team、値=bizdataStyleBookのタグを作成する(/en-us/netscaler-console-service/media/adm-create-tags-stylebook.png)さらにタグを追加するには、**+**をクリックします。
-
Createをクリックします。
タグを使用してStyleBookをフィルタリングするには、検索バーでTagsをクリックし、リストからキーと値を選択します。指定されたタグに一致するStyleBookが表示されます。
タグの使用方法(/en-us/netscaler-console-service/media/use-tags-stylebook.png)
以下は、タグを持つStyleBookの検索例です。
key=teamおよびvalue=bizdata：
タグの例(/en-us/netscaler-console-service/media/example-adm-tag.png)
StyleBookタグをその設定パックに関連付けることができます。そのため、StyleBookタグ自体を使用して設定パックを検索できます。
設定パックを作成する際は、タグの関連付けセクションで以下のいずれかのオプションを使用します。
-
現在および将来のすべてのStyleBookタグを設定に関連付ける – このオプションは、すべてのStyleBookタグを設定パックに関連付けます。また、将来StyleBookに追加する可能性のある新しいタグも確実に自動的に関連付けます。
-
タグを選択 – このオプションは、選択したStyleBookのタグを表示します。必要なStyleBookタグを選択し、設定パックに関連付けることができます。
StyleBookタグを設定パックに関連付ける(/en-us/netscaler-console-service/media/associate-tags-stylebook-configuration-pack.png)
StyleBookをクローンする
管理者は、StyleBookとその依存StyleBookの複製を作成できます。その後、このバンドルを
parametersおよびcomponentsセクションの更新などのカスタマイズに使用できます。
StyleBookをクローンするには：
-
アプリケーション > 設定 > StyleBooksに移動します。
-
複製したいデフォルトまたはカスタムのStyleBookで、クローンを選択します。StyleBookをクローンする(/en-us/netscaler-console-service/media/clone-stylebook.png)
-
StyleBookのクローンページで、StyleBookおよび依存StyleBookのネームスペースとバージョンを入力します。推奨されるネームスペースとバージョンを選択することもできます。StyleBookをクローンする(/en-us/netscaler-console-service/media/clone-stylebook-dependencies.png)注：クローンされたStyleBookとその依存StyleBookは、既存のStyleBookと区別するために異なるネームスペースとバージョンを持つ必要があります。クローンされたStyleBookには、予約済みのNetScaler Consoleネームスペースを使用することはできません。
-
クローン」をクリックします。クローンされたStyleBookパッケージがNetScaler Consoleにインポートされ、「StyleBooks」ページに表示されます。