StyleBook カテゴリー
NetScaler アプリケーション配信管理(ADM)には、StyleBookのカテゴリが2つあります。これらは、デフォルトのStyleBooksとカスタムStyleBookです。デフォルトでもカスタムでも、StyleBookはパブリックまたはプライベートのStyleBookです。NetScaler ADM では、タイプや表示状態に関係なく、システムに存在するすべてのStyleBookを表示できます。また、StyleBook同士がどのように接続されているかをグラフィカルに表示することもできます。
このドキュメントでは、StyleBookのさまざまなタイプについて説明します。また、NetScaler ADMのStyleBookに対して実行できる以下のアクションについても説明しています:
- カスタムStyleBookをダウンロードして修正するか、既存のStyleBookに基づいてStyleBookを作成します。
- ADMのデフォルトのStyleBookを非表示にします。
- NetScaler ADMからカスタムStyleBookを削除します。
- StyleBooks にタグを追加します。
デフォルトおよびカスタムStyleBook
- デフォルトのStyleBookは 、NetScaler ADMに同梱されているStyleBookで、NetScaler インスタンスに展開できる構成を作成できます。デフォルトの StyleBooks は削除できませんが、ADM GUI からは非表示にできます。
- カスタムStyleBookは 、NetScaler ADMにインポートした独自のStyleBookです。
デフォルトのStyleBookとカスタムStyleBookはどちらもパブリックまたはプライベートにすることができます。
パブリックおよびプライベートのStyleBook
構成パックを作成できるStyleBookは、パブリックStyleBookとして分類できます。つまり、これらはすべてNetScaler ADM GUIとAPIから直接使用して構成を作成できます。
しかし、一部のStyleBookは、他のStyleBookのビルディングブロックとして使用されます。そのようなStyleBookはプライベートとしてマークされます。プライベートStyleBookを直接使用して、NetScaler ADM GUIから構成パックを作成することはできません。ただし、NetScaler ADMでこれらのStyleBookを表示および表示することはできます。カスタムStyleBookのいずれかをプライベートとしてマークするには、 StyleBookのプライベート属性をtrueに設定します。NetScaler ADM APIを使用してプライベートStyleBookを使用して構成パックを作成することは引き続き可能です。
プライベートとしてマークされた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
<!--NeedCopy-->
StyleBook を見る
NetScaler ADMでは、StyleBookの数がデフォルトとプライベートの両方で増加しています。アクセスしたい特定のStyleBookを検索することもできます。また、両方のタイプのStyleBookを別々に表示することもできます。
NetScaler ADMで、[ アプリケーション ]>[ StyleBooks]に移動すると、システムに存在するStyleBookのリストを表示できます。
デフォルトのパブリックStyleBookのパネルには、次のアイコンがあります:
デフォルトのプライベートStyleBookには、プライベートStyleBookとして宣言するアイコンがあります。
プライベートStyleBookの定義と依存関係を表示することはできますが、GUIを使用してプライベートStyleBookから構成パックを作成することはできません。プライベートStyleBookの主な目的は、別のStyleBookのビルディングブロックとして使用することです。Building-blocks-StyleBooksを使用すると、一般的な構成パターンの再利用を促進します。
カスタムパブリック StyleBook には、次の図に示すように別のアイコンが表示されます。
カスタムプライベート StyleBookは次のアイコンで表示されますが、
ページの右上には、表示するStyleBookの種類を選択するオプションが表示されます。StyleBookには、すべて、パブリック、またはプライベートの 3 つのオプションがあります。オプションの 1 つをクリックします。
検索アイコンをクリックして、特定のStyleBookを検索することもできます。名前、名前空間、バージョン属性、またはこれらのオプションの組み合わせで検索できます。検索操作では、大文字と小文字は区別されません。
カスタムStyleBookをダウンロードする
NetScaler ADMからカスタムStyleBookをダウンロードするには、[ アプリケーション ]>[ StyleBooks ]>[ 構成]に移動します。右側のパネルに表示されるStyleBookのリストで、カスタム定義のStyleBookをダウンロードするオプションをオンにします。[Download] をクリックします。StyleBookに依存するカスタムStyleBookがある場合は、ダウンロードしたバンドルに依存するStyleBookを含めることができます。
注:
公開または非公開としてマークされているカスタムStyleBookをダウンロードできます。
注:
デフォルトのStyleBookはダウンロードできません。それらの定義と依存関係を表示できます。これを行うには、StyleBookパネルの「 表示定義 」および「 依存関係の表示 」リンクをクリックします。
カスタムStyleBookを更新する
NetScaler ADM GUI自体からカスタムStyleBook定義を更新できます。そのため、バージョンを変更せずにStyleBookに変更を加えることができます。StyleBookバンドルからインポートした定義を更新することもできます。
重要:
- NetScaler ADM GUIからStyleBook定義を更新する前に、StyleBook定義に依存するStyleBookがないことを確認してください。
- 構成パックを含むStyleBook定義を更新できます。
- StyleBook定義に下位互換性があることを確認してください。既存のStyleBookのすべてのパラメーターは、更新されたStyleBookに保持され、追加されたパラメーターはオプションとして表示されます。
-
アプリケーション > 構成 > StyleBooksに移動します。
-
カスタムStyleBook タブを選択します 。
-
更新するStyleBookで「定義の更新 」を選択します。
-
必要に応じて定義を更新し、[ 更新] をクリックします。
-
ページを更新して、最新の変更を確認します。
カスタムStyleBookを削除する
削除ボタンをクリックして、 カスタムStyleBookを削除することもできます 。NetScaler ADM からStyleBookを削除するかどうかを確認するポップアップウィンドウが表示されます。StyleBookが他のカスタムStyleBookを使用している場合は、チェックボックスを選択してそのようなStyleBookを削除できます。
注:
NetScaler ADMに依存するStyleBookがある場合は、カスタムStyleBookを削除しないでください。そうしないと、既存のStyleBookが壊れます。
StyleBookの依存関係を表示する
StyleBookの重要かつ便利な特徴の1つは、別のStyleBookの構築ブロックとして使用できる点です。StyleBookを別のStyleBookにインポートできます。インポートされたStyleBookは型として宣言され、2番目のStyleBookのコンポーネントまたはパラメータで使用されます。NetScaler ADMで既存のデフォルトのStyleBookを調べて、1つのStyleBookを別のStyleBookの上に構築する方法を学ぶことができます。
NetScaler ADM では、StyleBookの相互接続方法をグラフィカルに表示できます。この表現は、他のStyleBookをビルディングブロックとして使用して構築された複雑なStyleBookに特に便利です。ディペンデンシーグラフを見ると、複数のStyleBook間の関係や依存関係を確認できます。
他のStyleBookで使用されているStyleBookは、既存のStyleBookが壊れるため、システムから削除することはできません。ディペンデンシーグラフ表示を使用して、StyleBookの削除を妨げているStyleBookを特定できます。
StyleBookの依存関係を表示するには
NetScaler ADM で、[ アプリケーション ]>[ StyleBook]に移動します。 StyleBookページには 、NetScaler ADM で使用できるすべてのStyleBookが表示されます。下にスクロールして、StyleBookを見つけます。StyleBookタイルには 、構成の作成、StyleBookの定義の表示、StyleBookの依存関係の表示へのリンクが表示されます。[ 依存関係の表示] をクリックします。
フォワード依存関係
前方依存関係タブでは 、StyleBookが使用しているさまざまなデフォルトのStyleBookを表示できます。矢印に従って、StyleBookが使用しているStyleBookを見つけてください。矢印の1つにマウスを合わせると、矢印と相互に接続されているStyleBookが強調表示されます。StyleBookの名前をクリックして、そのStyleBookの定義を表示することもできます。
逆依存関係
「 逆依存関係 」タブでは、StyleBookを使用しているStyleBook をグラフィカルに表示できます。矢印に従えば、表示内のすべてのStyleBookがStyleBookの方向を指していることがわかります。StyleBookが直接使用している場合や、StyleBookが別のStyleBookを介してStyleBookを使用している場合があります。
ADC 構成を構成パックと照合して監査
StyleBook構成パックによって行われた変更を現在のADC構成と比較できます。この比較では、次の操作を実行できます:
-
StyleBook構成パックとADC構成の間の構成ドリフトを検出します。
-
構成パックによる変更を反映していないADC上の変更および削除されたオブジェクトを特定します。
構成パックの変更をADC構成と比較するには、次の手順を実行します:
-
「 アプリケーション 」>「 StyleBook 」>「 構成」に移動します。
-
「 構成監査」をクリックします。
構成監査ページには 、作成および監査されたオブジェクトが表示されます。
構成パックのサポートバンドルをダウンロードする
構成パックのサポートバンドルは、NetScalerテクニカルサポートチームが構成パックの問題を表示、分析、トラブルシューティングするのに役立ちます。
-
[ アプリケーション] > [構成] > [構成パック] > [サポートバンドル] で、構成パックを選択します。[Download] をクリックします。
-
サポートバンドルのダウンロードページで 、以下を指定します:
-
パスフレーズを使用して構成データを暗号化する-バンドルファイルを暗号化するパスフレーズを指定する場合は 、このオプションを選択します。
-
パスフレーズ-エクスポートバンドルを暗号化するパスフレーズを指定します 。このパスフレーズは、構成パックの機密データを保護します。パスフレーズは 20 文字以上でなければなりません。
-
圧縮ファイルタイプ -バンドルは ZIP または TGZ ファイル形式で圧縮できます。
-
-
[Download] をクリックします。
StyleBookのタグを作成する
NetScaler ADMでは、任意のStyleBookにタグを追加できます。タグは、異なる条件を使用してStyleBookをグループ化できるキーと値のペアです。これらのタグは、NetScaler ADMでStyleBookを検索またはフィルタリングするときに使用できます。
StyleBookにタグを追加するには:
-
「 アプリケーション 」>「 StyleBook」に移動します。
-
StyleBookで、タグを追加するタグを選択します。
すべてのタイプのStyleBookにタグを追加できます。
-
StyleBookをフィルタリングするのに役立つ、必要な キーと値の 情報を指定します。
たとえば、キー=チームと値=BizData
タグを追加するには、[ +] をクリックします。
-
[作成] をクリックします。
検索バーのタグを使用してStyleBookをフィルタリングするには、「 タグ 」をクリックし、リストからキーと値を選択します。指定したタグに一致するStyleBookが表示されます。
次に、key=team
およびvalue=bizdata
というタグを持つ StyleBooks を検索する例を示します。
StyleBookタグを構成パックに関連付けることができます。そのため、StyleBookタグ自体を使用して構成パックを検索できます。
構成パックを作成するときは、 タグ関連付けセクションで以下のオプションのいずれかを使用してください :
-
現在および将来のすべてのStyleBookタグを構成に関連付ける — このオプションは 、すべてのStyleBookタグを構成パックに関連付けます。また、今後StyleBooksに追加する可能性のある新しいタグを必ず関連付けます。
-
「タグの選択」 -このオプションは、選択したStyleBookのタグを表示します。必要なStyleBookタグを選択し、構成パックに関連付けることができます。
CLI コマンドを使用してStyleBookを設定するには
CLIコマンドを使用してStyleBookを設定する場合は、以下を実行してください。
- NetScalerで
show ns runningConfig
コマンドを実行します。 - NetScaler ADM で、 [デフォルトのStyleBook、 [ビジネスアプリケーションのStyleBook](/ja-jp/netscaler-application-delivery-management-software/current-release/stylebooks/business-application-stylebooks.html)、またはカスタムStyleBookのいずれかを使用して構成を作成します](/en-us/netscaler-application-delivery-management-software/current-release/stylebooks/how-to-use-default-stylebooks.html)。
- NetScalerで
show ns runningConfig
コマンドを再実行します。
2つの出力の違いには、NetScaler CLIを使用して任意のStyleBookを構成するために使用できるCLIコマンドが表示されます。