StyleBookのカテゴリ
NetScaler Consoleには、デフォルトとカスタムの2つのStyleBookカテゴリがあります。これらはパブリックまたはプライベートのいずれかになります。NetScaler Consoleでは、システムに存在するすべてのStyleBookと、それらがどのように相互に接続されているかを表示できます。
このドキュメントでは、さまざまな種類のStyleBookと、NetScaler ConsoleからStyleBookに対して実行できる次のアクションについて説明します。
-
カスタムStyleBookをダウンロードして変更を加えるか、既存のStyleBookに基づいて新しいStyleBookを作成します。
-
NetScaler ConsoleのデフォルトStyleBookを非表示にします。
-
NetScaler ConsoleからカスタムStyleBookを削除します。
-
StyleBookにタグを追加します。
Related information
デフォルト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から設定パックを直接作成するために使用することはできません。ただし、NetScaler ConsoleでこれらのStyleBookを表示および閲覧することはできます。カスタム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を検索することもできます。名前、名前空間、バージョン属性、またはこれらのオプションの組み合わせで検索できます。検索操作では大文字と小文字は区別されません。
StyleBooksを検索(/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の更新(/en-us/netscaler-console-service/media/update-stylebook-definition-inline.gif)
-
ページを更新して最新の変更を確認します。
カスタムStyleBookの削除
削除ボタンをクリックして、カスタムStyleBookを削除することもできます。ポップアップウィンドウが表示され、NetScaler ConsoleからStyleBookを削除するかどうかを確認するメッセージが表示されます。StyleBookが他のカスタムStyleBookを使用している場合は、チェックボックスをオンにして、それらのStyleBookを削除することを選択できます。
StyleBookの削除(/en-us/netscaler-console-service/media/mas-delete-custom-stylebooks-new.png)
注：
NetScaler Consoleに依存するStyleBookがある場合、カスタムStyleBookを削除しないでください。この操作により、既存のStyleBookが破損する可能性があります。
StyleBookの依存関係の表示
StyleBookの重要かつ強力な機能は、他の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インスタンス構成と比較するには、次の手順を実行します。
-
アプリケーション > 設定 > コンフィグパック に移動します。
-
「Configuration Audit」をクリックします。「Configuration Audit」ページには、作成および監査されたオブジェクトが表示されます。config pack に対する NetScaler 構成の監査(/en-us/netscaler-console-service/media/configuration-audit-configpack.png)
注:
NetScaler インスタンスに展開されている StyleBook config pack を更新する際、展開された状態と異なる場合があります。その場合、config pack の更新は失敗します。StyleBook エンジンは、これらの違いを自動的に調整し、config pack を更新します。
config pack のサポートバンドルをダウンロードする
config pack のサポートバンドルは、Citrix テクニカルサポートチームが config pack の問題を表示、分析、トラブルシューティングするのに役立ちます。サポートバンドルをダウンロードするには、次の手順を実行します。
-
Applications > Configuration > Config Packs の順に移動します。
-
サポートバンドルをダウンロードする config pack を選択します。
-
Select Action で、Support Bundle をクリックします。バンドルは、Zip または TGZ ファイル形式で圧縮できます。
-
オプション: バンドルファイルを暗号化するためのパスフレーズを指定します。
-
Download をクリックします。
サポートバンドル(/en-us/netscaler-console-service/media/support-bundle-configpack.png)
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情報を指定します。例えば、Keyがteamで、Valueがbizdataです。StyleBookのタグを作成(/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)
以下は、
key=teamとvalue=bizdataのタグを持つStyleBookの検索例です。
タグの例(/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」ページに表示されます。