StyleBook カテゴリー
NetScaler Consoleには、デフォルトとカスタムの2つのStyleBookカテゴリがあり、パブリックでもプライベートでもかまいません。NetScaler Consoleでは、システムに存在するすべてのStylebookと、それらがどのように相互に接続されているかを確認できます。
このドキュメントでは、さまざまなタイプのStylebookと、NetScaler ConsoleからStylebookで実行できる次のアクションについて説明します：
- カスタムStyleBookをダウンロードして修正するか、既存のStyleBookに基づいてStyleBookを作成します。
- NetScaler コンソールのデフォルトStyleBook を非表示にします。
- NetScaler コンソールからカスタムStyleBook を削除します。
- StyleBooks にタグを追加します。
デフォルトおよびカスタムStyleBook
- デフォルトのStyleBookはNetScaler Consoleに付属しているStyleBook で、NetScalerインスタンスに展開できる構成を作成できます。デフォルトのStylebookは削除できませんが、NetScalerコンソールGUIから非表示にすることはできます。
- カスタムStyleBookは 、NetScaler コンソールにインポートした独自のStyleBook です。
デフォルトのStyleBookとカスタムStyleBookはどちらもパブリックまたはプライベートにすることができます。
パブリックおよびプライベートのStyleBook
構成パックを作成できるStyleBookは、パブリックStyleBookとして分類できます。つまり、これらはすべてNetScalerコンソールのGUIとAPIから直接構成を作成するために使用できます。
しかし、一部のStyleBookは、他のStyleBookのビルディングブロックとして使用されます。そのようなStyleBookはプライベートとしてマークされます。プライベートStyleBook を使用して、NetScalerコンソールGUIから構成パックを直接作成することはできません。ただし、これらのStyleBook は引き続きNetScalerコンソールで表示および表示できます。カスタムStyleBookのいずれかをプライベートとしてマークするには、 StyleBookのプライベート属性をtrueに設定します。プライベートStyleBook を使用して、NetScalerコンソール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
<!--NeedCopy-->
StyleBook を見る
NetScaler Consoleでは、デフォルトとプライベートの両方のStyleBook の数が増えています。アクセスしたい特定のStyleBookを検索することもできます。また、両方のタイプのStyleBookを別々に表示することもできます。
NetScaler Consoleで、［ アプリケーション］>［構成］>［StyleBook］に移動すると、システムに存在するStyleBook のリストを表示できます。
デフォルトのパブリック StyleBookのパネルには、次のアイコンがあります。
デフォルトのプライベートStyleBookにはプライベートStyleBookであることを宣言するアイコンがありますが：
プライベートStyleBookの定義と依存関係を表示することはできますが、GUIを使用してプライベートStyleBookから構成パックを作成することはできません。プライベートStyleBookの主な目的は、別のStyleBookのビルディングブロックとして使用することです。Building-blocks-StyleBooksを使用すると、一般的な構成パターンの再利用を促進します。
カスタムパブリック StyleBook には、次の図に示すように別のアイコンが表示されます。
カスタムプライベート StyleBookは次のアイコンで表示されますが、
ページの右上には、表示するStyleBookの種類を選択するオプションが表示されます。StyleBookには、すべて、パブリック、またはプライベートの 3 つのオプションがあります。オプションの 1 つをクリックします。
検索アイコンをクリックして、特定のStyleBookを検索することもできます。名前、名前空間、バージョン属性、またはこれらのオプションの組み合わせで検索できます。検索操作では、大文字と小文字は区別されません。
カスタムStyleBookをダウンロードする
NetScaler ConsoleからカスタムStyleBookをダウンロードするには、［ アプリケーション］>［構成］>［構成パック］に移動します。右側のパネルに表示されるStyleBookのリストで、カスタム定義のStyleBookをダウンロードするオプションをオンにします。［Download］ をクリックします。StyleBookに依存するカスタムStyleBookがある場合は、ダウンロードしたバンドルに依存するStyleBookを含めることができます。
注:
公開または非公開としてマークされたカスタム StyleBooks をダウンロードできます。
注
NetScaler コンソールのデフォルトStylebookはダウンロードできません。それらの定義と依存関係を表示できます。これを行うには、StyleBookパネルの「 表示定義 」および「 依存関係の表示 」リンクをクリックします。
カスタムStyleBookを更新する
カスタムStyleBook 定義は、NetScalerコンソールのGUI自体から更新できます。そのため、バージョンを変更せずにStyleBookを変更できます。StyleBookバンドルからインポートした定義を更新することもできます。
重要
：NetScalerコンソールのGUIからStyleBook 定義を更新する前に、StyleBook 定義に依存するStyleBook がないことを確認してください。
構成パックを含むStyleBook定義を更新できます。StyleBook定義に下位互換性があることを確認してください。そのため、すべてのパラメーターは更新されたStyleBookに保存され、新しく追加されたパラメーターはオプションとして表示されます。
-
アプリケーション > 構成 > StyleBooksに移動します。
-
カスタムStyleBook タブを選択します 。
-
更新するStyleBookで「定義の更新 」を選択します。
-
必要に応じて定義を更新し、[ 更新] をクリックします。
-
ページを更新して、最新の変更を確認します。
カスタムStyleBookを削除する
削除ボタンをクリックして、 カスタムStyleBookを削除することもできます 。ポップアップウィンドウが開き、NetScaler コンソールから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 コンソールで、[ アプリケーション] > [構成] [StyleBook **] に移動します。StyleBook ページには、NetScaler コンソールで使用できるすべてのStyleBook が表示されます。下にスクロールして、StyleBookを見つけます。「依存関係を表示** 」をクリックして、依存するStyleBookを表示します。
前方依存関係
前方依存関係タブでは 、StyleBookが使用しているさまざまなデフォルトのStyleBookを表示できます。矢印に従って、StyleBookが使用しているStyleBookを見つけてください。矢印の1つにマウスを合わせると、矢印と相互に接続されているStyleBookが強調表示されます。Stylebookをクリックして、そのStylebookの定義を表示することもできます。
逆依存関係
「 逆依存関係 」タブでは、StyleBookを使用しているStyleBook をグラフィカルに表示できます。矢印に従えば、表示内のすべてのStyleBookがStyleBookの方向を指していることがわかります。StyleBookが直接使用している場合や、StyleBookが別のStyleBookを介してStyleBookを使用している場合があります。
NetScaler構成を構成パックと照合して監査する
StyleBook構成パックによって加えられた変更を、現在のNetScaler構成と比較することができます。この比較では、次の操作を実行できます：
-
StyleBook構成パックとNetScaler構成の間の構成ドリフトを検出します。
-
NetScaler上の変更および削除されたオブジェクトのうち、構成パックによる変更が表示されないものを特定します。
構成パックの変更をNetScalerインスタンス構成と比較するには、次の操作を行います：
-
[ アプリケーション] > [構成] > [構成パック] に移動します。
-
「 構成監査」をクリックします。
「構成の監査」ページには、作成および監査されたオブジェクトが表示されます。
注：
NetScalerインスタンスに展開されているStyleBook構成パックを更新すると、展開された状態と異なる場合があります。また、構成パックの更新に失敗します。StyleBookエンジンはこれらの違いを自動的に調整し、構成パックを更新します。
構成パックのサポートバンドルをダウンロードする
構成パックのサポートバンドルは、Citrix のテクニカルサポートチームが構成パックの問題を表示、分析、トラブルシューティングするのに役立ちます。サポートバンドルをダウンロードするには、以下の手順を実行します：
-
[ アプリケーション] > [構成] > [構成パック] に移動します。
-
サポートバンドルのダウンロード先となる設定パックを選択します。
-
「アクションを選択」で、「 サポートバンドル」をクリックします。
バンドルは Zip または TGZ ファイル形式で圧縮できます。
-
オプションで、バンドルファイルを暗号化するパスフレーズを指定します。
-
［Download］ をクリックします。
StyleBookのタグを作成する
タグはNetScalerコンソールのどのStyleBook にも追加できます。タグは、異なる条件を使用してStyleBookをグループ化できるキーと値のペアです。これらのタグは、NetScaler ConsoleでStyleBook を検索またはフィルタリングする際に使用できます。
StyleBookにタグを追加するには：
-
アプリケーション > 構成 > StyleBooksに移動します。
-
StyleBookで、タグを追加するタグを選択します。
すべてのタイプのStyleBookにタグを追加できます。
-
StyleBookをフィルタリングするのに役立つ、必要な キーと値の 情報を指定します。
たとえば、キー=チームと値=BizData
タグを追加するには、[ +] をクリックします。
-
［作成］ をクリックします。
タグを使用してStyleBookをフィルタリングするには、検索バーの「 タグ 」をクリックし、リストからキーと値を選択します。指定したタグと一致するStylebookが表示されます。
次に、key=teamおよびvalue=bizdataというタグを持つ StyleBooks を検索する例を示します。
StyleBookタグを構成パックに関連付けることができます。そのため、StyleBookタグ自体を使用して構成パックを検索できます。
構成パックを作成するときは、 タグ関連付けセクションで以下のオプションのいずれかを使用してください ：
-
現在および将来のすべてのStyleBookタグを構成に関連付ける — このオプションは 、すべてのStyleBookタグを構成パックに関連付けます。また、今後StyleBooksに追加する可能性のある新しいタグを必ず関連付けます。
-
「タグの選択」 -このオプションは、選択したStyleBookのタグを表示します。必要なStyleBookタグを選択し、構成パックに関連付けることができます。
Stylebookの複製
管理者は、StyleBookとそれに依存するStyleBookの複製を作成できます。その後、このバンドルを使用して、 parametersやcomponentsセクションの更新などのカスタマイズを行うことができます。
Stylebookを複製するには：
-
アプリケーション > 構成 > StyleBooksに移動します。
-
複製したいデフォルトまたはカスタムのStyleBookで 「複製」を選択します。
-
「 Stylebookの複製 」ページで、Stylebookと依存Stylebookの名前空間とバージョンを入力します。推奨の名前空間とバージョンを選択することもできます。
注：
複製されたStyleBookとそれに依存するStyleBookには、既存のStyleBookと区別するために異なる名前空間とバージョンが必要です。複製されたStylebookには、NetScaler Consoleの予約済み名前空間を使用することはできません。
-
[ 複製] をクリックします。複製されたStylebookパッケージがNetScaler Consoleにインポートされ、Stylebookページに表示されます。