StyleBookのカテゴリ
NetScaler Consoleには、デフォルトのStyleBookとカスタムStyleBookの2つのStyleBookカテゴリがあります。StyleBookは、デフォルトかカスタムかに関わらず、パブリックまたはプライベートのStyleBookのいずれかです。NetScaler Consoleでは、種類や表示ステータスに関係なく、システムに存在するすべてのStyleBookを表示できます。また、StyleBookが互いにどのように接続されているかをグラフィカルに表示することもできます。
このドキュメントでは、さまざまな種類のStyleBookについて説明します。また、NetScaler ConsoleからStyleBookに対して実行できる次のアクションについても説明します。
-
カスタムStyleBookをダウンロードして変更を加えるか、既存のStyleBookに基づいてStyleBookを作成します。
-
デフォルトのStyleBookを非表示にします。
-
NetScaler ConsoleからカスタムStyleBookを削除します。
-
StyleBookにタグを追加します。
デフォルトおよびカスタムStyleBook
-
デフォルトのStyleBookは、NetScaler Consoleに付属しているStyleBookであり、NetScalerインスタンスに展開できる構成を作成できます。デフォルトのStyleBookを削除することはできませんが、NetScaler Console GUIから非表示にすることができます。
-
カスタムStyleBookは、NetScaler Consoleにインポートした独自の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 > StyleBooks に移動すると、システムに存在するStyleBookのリストを表示できます。
デフォルトのパブリックStyleBookには、そのパネルに次のアイコンがあります。
一方、デフォルトのプライベートStyleBookには、それがプライベートStyleBookであることを示すアイコンがあります。
プライベートStyleBookの定義と依存関係は表示できますが、GUIを使用してプライベートStyleBookから構成パックを作成することはできません。プライベートStyleBookの主な目的は、別のStyleBookの構成要素として使用することです。構成要素となるStyleBookを使用することで、一般的な構成パターンを再利用できます。
カスタムのパブリックStyleBookには、次の図に示すように異なるアイコンがあります。
一方、カスタムのプライベートStyleBookは、このアイコンで表示されます。
ページの右上には、表示するStyleBookのタイプを選択するオプションがあります。「すべて」、「パブリック」、または「プライベート」の3つのオプションがあります。いずれかのオプションをクリックします。
検索アイコンをクリックして、特定のStyleBookを検索することもできます。名前、名前空間、バージョン属性、またはこれらのオプションの組み合わせで検索できます。検索操作では大文字と小文字は区別されません。
カスタムStyleBookをダウンロード
NetScaler ConsoleからカスタムStyleBookをダウンロードするには、Applications > StyleBooks > Configurationsの順に移動します。右側のパネルに表示されるStyleBookのリストで、カスタム定義のStyleBookをダウンロードするオプションをオンにします。Downloadをクリックします。StyleBookに依存するカスタムStyleBookがある場合は、依存するStyleBookをダウンロードしたバンドルに含めることができます。
注:
パブリックまたはプライベートとしてマークされているカスタムStyleBookをダウンロードできます。
注:
デフォルトのStyleBookはダウンロードできません。それらの定義と依存関係を表示できます。これを行うには、StyleBookパネルのView DefinitionおよびView Dependenciesリンクをクリックします。
カスタムStyleBookを更新
NetScaler Console GUI自体からカスタムStyleBookの定義を更新できます。これにより、バージョンを変更せずにStyleBookに変更を加えることができます。StyleBookバンドルからインポートされた定義を更新することもできます。
重要:
-
NetScaler Console GUIからStyleBook定義を更新する前に、StyleBook定義に依存するStyleBookがないことを確認してください。
-
設定パックを持つStyleBook定義を更新できます。
-
StyleBook定義が下位互換性があることを確認してください。既存のStyleBookのすべてのパラメータは更新されたStyleBookに保持され、追加されたパラメータはオプションとして表示されます。
-
Applications > Configuration > StyleBooksの順に移動します。
-
「カスタムStyleBook」タブを選択します。
-
更新するStyleBookで「定義の更新」を選択します。
-
必要に応じて定義を更新し、「更新」をクリックします。カスタムStyleBookを更新(/en-us/netscaler-application-delivery-management-software/media/update-stylebook-definition-inline.gif)
-
ページを更新して最新の変更を確認します。
カスタムStyleBookを削除する
「削除」ボタンをクリックして、カスタムStyleBookを削除することもできます。ポップアップウィンドウが表示され、NetScaler ConsoleからStyleBookを削除するかどうかを確認するメッセージが表示されます。StyleBookが他のカスタムStyleBookを使用している場合は、チェックボックスをオンにして、それらのStyleBookを削除することを選択できます。
StyleBookを削除(/en-us/netscaler-application-delivery-management-software/media/mas-delete-custom-stylebooks-new.png)
「注:」:
NetScaler Consoleに依存するStyleBookがある場合は、カスタムStyleBookを削除しないでください。削除すると、既存のStyleBookが破損します。
StyleBookの依存関係を表示する
StyleBookの重要かつ強力な機能の1つは、他のStyleBookの構成要素として使用できることです。あるStyleBookを別のStyleBookにインポートできます。インポートされたStyleBookはタイプとして宣言され、2番目のStyleBookのコンポーネントまたはパラメータによって使用されます。NetScaler Consoleの既存のデフォルトStyleBookを調べて、あるStyleBookが別のStyleBookの上にどのように構築できるかを学ぶことができます。
NetScaler Consoleでは、StyleBookが互いにどのように接続されているかをグラフィカルに表示できます。この表現は、他のStyleBookを構成要素として使用して構築された複雑なStyleBookにとって特に役立ちます。依存関係グラフを見ることで、複数のStyleBook間の関係と依存関係を確認できます。
他のStyleBookで使用されているStyleBookは、既存のStyleBookを破損させるため、システムから削除できません。依存関係グラフ表示を使用すると、どのStyleBookがStyleBookの削除を妨げているかを特定できます。
StyleBookの依存関係を表示するには
NetScaler Consoleで、Applications > StyleBooksに移動します。StyleBooksページには、NetScaler Consoleで使用できるすべてのStyleBookが表示されます。下にスクロールして、目的のStyleBookを見つけます。StyleBookタイルには、構成の作成、StyleBook定義の表示、およびStyleBookの依存関係の表示へのリンクが表示されます。View Dependenciesをクリックします。
順方向の依存関係
Forward Dependenciesタブでは、お使いのStyleBookが使用しているさまざまなデフォルトのStyleBookを表示できます。矢印をたどって、StyleBookが使用しているStyleBookを見つけます。いずれかの矢印にマウスを合わせると、その矢印と相互に接続されているStyleBookが強調表示されます。StyleBook名をクリックして、そのStyleBookの定義を表示することもできます。
順方向の依存関係(/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-forward-dependencies.png)
逆方向の依存関係
Reverse Dependenciesタブでは、お使いのStyleBookを使用しているStyleBookをグラフィカルに表示できます。矢印をたどると、表示されているすべてのStyleBookがお使いのStyleBookを指していることがわかります。一部のStyleBookは直接StyleBookを使用している場合があり、一部のStyleBookは別のStyleBookを介してStyleBookを使用している場合があります。
逆方向の依存関係(/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-reverse-dependencies.png)
設定パックに対するNetScaler構成の監査
StyleBook設定パックによって行われた変更を、現在のNetScaler構成と比較できます。この比較により、次のことができます。
-
StyleBook設定パックとNetScaler構成間の設定ドリフトを検出します。
-
設定パックによって行われた変更を反映していない、NetScaler上の変更済みおよび削除済みオブジェクトを特定します。
設定パックの変更をNetScaler構成と比較するには、次の手順を実行します。
-
Applications > StyleBooks > Configurationsに移動します。
-
Configuration Auditをクリックします。Configuration Auditページには、作成および監査されたオブジェクトが表示されます。構成パックに対するNetScaler構成の監査(/en-us/netscaler-application-delivery-management-software/media/configuration-audit-configpack.png)
構成パックのサポートバンドルをダウンロードする
構成パックのサポートバンドルは、NetScaler®テクニカルサポートチームが構成パックの問題を表示、分析、トラブルシューティングするのに役立ちます。
-
Applications > Configuration > Config Packs > Support Bundlesで、構成パックを選択します。Downloadをクリックします。
-
Download Support Bundleページで、以下を指定します。
-
パスフレーズを使用して構成データを暗号化する - バンドルファイルを暗号化するためのパスフレーズを指定する場合は、このオプションを選択します。
-
パスフレーズ - エクスポートバンドルを暗号化するためのパスフレーズを指定します。このパスフレーズは、構成パックの機密データを保護します。パスフレーズは20文字以上である必要があります。
-
圧縮ファイルタイプ - バンドルをZIPまたはTGZファイル形式で圧縮できます。
-
-
Downloadをクリックします。
サポートバンドル(/en-us/netscaler-application-delivery-management-software/media/support-bundle-configpack.png)
StyleBookのタグを作成する
NetScaler Consoleの任意のStyleBookにタグを追加できます。タグは、さまざまな基準を使用してStyleBookをグループ化できるキーと値のペアです。NetScaler ConsoleでStyleBookを検索またはフィルタリングする際に、これらのタグを使用できます。
StyleBookにタグを追加するには：
-
Applications > StyleBooksに移動します。
-
タグを追加したいStyleBookでTagsを選択します。
すべての種類のStyleBookにタグを追加できます。 -
StyleBookのフィルタリングに役立つ、必要なキーと値の情報を指定します。例えば、Key=team と Value=bizdata
さらにタグを追加するには、**+**をクリックします。 -
作成をクリックします。
検索バーでタグを使用してStyleBookをフィルタリングするには、タグをクリックし、リストからキーと値を選択します。指定されたタグに一致するStyleBookが表示されます。
以下は、
key=teamおよびvalue=bizdataのタグを持つStyleBookの検索例です。
StyleBookタグをそのconfig packに関連付けることができます。そのため、StyleBookタグ自体を使用してconfig packを検索できます。
config packを作成する際は、タグ関連付けセクションで以下のいずれかのオプションを使用します。
-
現在および将来のすべてのStyleBookタグを構成に関連付ける – このオプションは、すべてのStyleBookタグをconfig packに関連付けます。また、将来StyleBookに追加する可能性のある新しいタグも関連付けられるようにします。
-
タグを選択 – このオプションは、選択したStyleBookのタグを表示します。必要なStyleBookタグを選択し、config packに関連付けることができます。
CLIコマンドを使用してStyleBookを設定するには
CLIコマンドを使用してStyleBookを設定する場合は、次の手順を実行します。
-
NetScalerで
show ns runningConfigコマンドを実行します。 -
NetScalerで
show ns runningConfigコマンドを再度実行します。
2つの出力の差分は、NetScaler CLIを使用してStyleBookを設定するために使用できるCLIコマンドを表示します。
StyleBookをクローンする
管理者は、StyleBookとその依存StyleBookの複製を作成できます。このバンドルは、
parametersセクションとcomponentsセクションの更新などのカスタマイズに使用できます。
StyleBookをクローンするには：
-
Applications > Configuration > StyleBooks に移動します。
-
複製したいデフォルトまたはカスタムのStyleBookで、Clone を選択します。
-
Clone StyleBook ページで、StyleBookと依存StyleBookのネームスペースとバージョンを入力します。推奨されるネームスペースとバージョンを選択することもできます。
注：クローンされたStyleBookとその依存するStyleBookは、既存のStyleBookと区別するために、異なる名前空間とバージョンを持つ必要があります。クローンされたStyleBookに対して、予約済みのNetScaler Console名前空間を使用することはできません。 -
「クローン」をクリックします。クローンされたStyleBookパッケージはNetScaler Consoleにインポートされ、「StyleBooks」ページに表示されます。