構成パックの作成と編集
NetScalerアプリケーション配信管理（ADM）では、StyleBookから構成パックを作成できます。また、構成パックは作成元のStyleBookに関連付けられています。構成パックの更新は、それが関連付けられているStyleBookを通じて行われます。
構成パックを作成する
StyleBookから構成パックを作成するには、以下を実行してください：
-
[ アプリケーション] > [StyleBooks] > [構成]に移動します
-
［追加］ をクリックします。
-
「 StyleBookの選択」で、構成パックを作成したい必要なStyleBookを選択します。
このページでは、StyleBookをデフォルトとカスタムStyleBookに分類しています。それぞれのタブを選択して、必要なStyleBookを見つけます。
-
アプリケーション名、IPアドレス、ポート、プロトコルタイプなど、必要な詳細を指定します。
GUIフィールドは、あるStyleBookから別のStyleBookによって異なります。
-
[ ターゲットインスタンス] で、設定を実行するインスタンスまたはインスタンスグループを選択します。
注：
必要な数のターゲットインスタンスを指定することで、構成を複数のNetScalerに展開できます。
-
[ ドライラン] をクリックします。
[ オブジェクト ] ページには、NetScaler インスタンスから作成、変更、または削除されるオブジェクトが表示されます。
-
［作成］ をクリックします
構成パックは、 StyleBook >構成ページに表示されます。
既存の構成パックを編集する場合は、構成パックを選択し、「 編集」をクリックします。
構成パックのStyleBookを変更
機能を追加したり、問題を解決したりするために、StyleBookを更新する必要がある場合があります。古いStyleBookを使用して構成パックを既に作成している場合は、新しく更新されたStyleBookを使用するように構成パックを更新することをお勧めします。新しいStyleBookを使用するには、構成パックの既存のStyleBookを変更してください。
ADC インスタンスに基本的なロードバランサー設定をデプロイする StyleBook example-lb の例を考えてみましょう。そして、このStyleBookから構成パック CP1 を作成します。
基本的なロードバランサー設定でモニターを構成する場合は、新しいStyleBookが必要です。したがって、基本的なロードバランサー設定とともにモニターを構成する機能を含む、 例 lb-mon StyleBook を作成します。
StyleBookを作成したら、既存の構成パックCP1を更新してモニターを追加します。これを行うには、次の手順を実行します：
-
[ アプリケーション] > [StyleBooks] > [構成]に移動します
-
StyleBookを変更したい構成パックを選択します。
この例では、リストから CP1 を選択します。
-
「 StyleBookの変更」をクリックします。
-
リストから必要なStyleBookを選択します。次に、[ 選択を保存] をクリックします。
-
［変更］をクリックします。
この例では、リストから example-lb-mon を選択します。
構成パックのStyleBookを変更すると、新しいStyleBookのパラメーターの構造が既存のStyleBookとは異なる場合があります。パラメータ構造が以前のStyleBookに似ている場合、パラメータの値はそれぞれのフィールドに自動的に保持されます。それ以外の場合は、2つのStyleBook間で同じ構造を持つパラメータのみが転送されます。たとえば、同じパラメータ名、タイプ、パラメータの親など。
新しいStyleBookに新しい必須パラメータを追加する場合は、StyleBookを変更した後、そのようなパラメータの値を手動で指定する必要があります。
この例では、 example-lb StyleBook の設定ページに表示されるパラメータは次のとおりです：
新しい example-lb-mon StyleBook の設定ページに表示されるパラメーターは次のとおりです：
この場合、新しいStyleBookは既存のパラメータを変更していないため、StyleBooksは基本的なロードバランサー設定の古い値を保持します。そして、それは新しいパラメータだけを追加します。モニタパラメータの場合は、必要な値を手動で指定します。
-
[ ターゲットインスタンス] で、選択したインスタンスを確認し、必要に応じてリストを更新します。
-
[ ドライラン] をクリックします。
[ オブジェクト ] ページには、NetScaler インスタンスから作成、変更、または削除されるオブジェクトが表示されます。
-
［OK］ をクリックします。
「 StyleBook」>「構成 」ページの「 StyleBook名 」列には、選択した構成パックの新しいStyleBook名が表示されます。この場合、 example-lb-monと表示されます。
複数の構成パックを含むStyleBookを変更する
複数の構成パックを含む既存のStyleBookを変更する場合は、次の操作を行います：
-
新しいStyleBookをADMにインポートします。
通常、新しいStyleBookの名前と名前空間は、既存のStyleBookよりも高いバージョンを持ちます。ただし、名前、名前空間、またはバージョンが異なる場合は、この手順を省略できます。
-
既存のStyleBook に関連付けられている構成パックのStyleBook を変更します。
「 StyleBook を変更 」を選択できるのは、選択した構成パックが同じStyleBook に関連付けられている場合のみです。
選択した構成パックについて、次の条件が満たされると、ADMはStyleBookを正常に変更します：
-
既存のStyleBookの設定パラメータはすべて、選択したStyleBookに存在する必要があります。
-
選択したStyleBookの新しいパラメータはオプションです。
選択した構成パックの進行状況を確認するには、構成ページで「 進行中の構成/失敗 」を選択します。
-
-
すべての構成パックが新しいStyleBookに関連付けられたら、古いStyleBookをADMから削除します。
構成パックのエクスポートまたはインポート
StyleBooksのような構成パックをエクスポートまたはインポートできます。この機能を使用すると、StyleBook設定を別のADMサーバーに簡単に共有できます。構成パックをエクスポートすると、tgzまたはzipバンドルがローカルコンピューターにダウンロードされます。このバンドルには、構成パックで定義されたすべてのパラメーターを含む JSON ファイルが含まれています。
設定のエクスポート
構成パックをエクスポートするには、次の操作を行います：
-
[ アプリケーション] > [StyleBooks] > [構成]に移動します
-
エクスポートする構成パックを選択します。
-
「アクションの選択」で、「 構成のエクスポート」を選択します。
-
[ 構成のエクスポート ] ペインで、次の項目を指定します。
-
設定がデプロイされるターゲットインスタンス情報: エクスポートバンドルにターゲットインスタンスの情報を含めるには、このオプションを選択します。
-
設定に関連付けられたStyleBook: StyleBookをエクスポートバンドルに含めるには、このオプションを選択します。
-
エクスポート設定データを保護するためのパスフレーズ：エクスポートバンドルを暗号化するためのパスフレーズを指定します。このパスフレーズは、構成パックの機密データを保護します。
-
圧縮ファイルの種類: ZIP または TGZ ファイルタイプを選択します。
-
-
［エクスポート］ をクリックします。
エクスポートバンドルをローカルコンピューターに保存します。
構成をインポート
構成パックは、ローカルコンピューターから別の ADM サーバーにインポートできます。構成パックをインポートするには、次の操作を行います：
-
[ アプリケーション] > [StyleBooks] > [構成]に移動します
-
[ 構成のインポート] を選択します。
-
コンピュータからインポートファイルバンドルを選択します。
-
エクスポート時に指定したパスフレーズを使用します。
-
オプションで、[詳細オプション] で、[ ADC にすべての設定オブジェクトが存在する場合にのみ、新しい構成の作成を許可する] を選択します。
このオプションでは、ADC インスタンスにすでに作成されているオブジェクトは変更されません。
同じ ADC インスタンスを 2 つの ADM サーバに追加したとします。また、ある ADM サーバーから別のサーバーに構成パックを移行する必要があります。このオプションを使用すると、ADC インスタンス上の設定オブジェクトを変更せずに構成パックをインポートできます。
重要：
このオプションを使用するには、指定された設定バンドルにターゲットインスタンス情報が含まれていることを確認してください。「設定のエクスポート」を参照してください。
このオプションは、すべてのオブジェクトがターゲットインスタンスに存在する場合のみ、設定を移行します。
-
［インポート］ をクリックします。
構成パックをインポートすると、ADM は以下を確認します：
-
関連するStyleBook:関連するStyleBookがADMにない場合は、構成パックとともにStyleBookがインポートされます。
-
ターゲットインスタンス: ターゲットインスタンスをチェックし、指定したターゲットインスタンスに設定をデプロイします。前述の ADC インスタンスが ADM に存在しない場合、構成パックはターゲットインスタンスなしでインポートされます。
-
ソース ADM: 同じ ADM サーバーに構成パックをインポートする場合、選択したバンドルによって既存の構成パックが更新されます。
ターゲットインスタンスを構成パックからデタッチする
ターゲットインスタンスを構成パックからデタッチするには、以下を実行します：
-
[ アプリケーション] > [構成] > [構成パック] に移動します。
-
削除するターゲットインスタンスのある構成パックを選択します。
-
「アクションを選択」で、「 ターゲットをデタッチ」を選択します。
-
Detach Targets ペインで、構成パックから削除するターゲットインスタンスを選択します。
-
［OK］ をクリックします。
ターゲットインスタンスが削除された状態で、重複する構成パックが作成されたことを確認するメッセージが表示されます。
StyleBook を構築する
example-lb StyleBook の全コンテンツは、以下の参照用に提供されています。
name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
-
namespace: com.citrix.adc.stylebooks
prefix: stlb
version: "1.0"
parameters-default-sources:
- stlb::lb
components:
-
name: lb-comp
type: stlb::lb
description: Uses the default lb StyleBook to build the typical lb configuration objects
properties-default-sources:
- $parameters
<!--NeedCopy-->
example-lb-mon StyleBook の全コンテンツは、参照用に次のように提供されます。
name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
prefix: ns
version: "10.5"
-
namespace: com.citrix.adc.stylebooks
prefix: stlb
version: "1.0"
-
namespace: com.citrix.adc.commontypes
prefix: cmtypes
version: "1.0"
parameters-default-sources:
- stlb::lb
parameters:
-
name: monitors
label: "List of Monitors"
description: "List of Monitors to monitor Application Servers"
type: cmtypes::monitor[]
substitutions:
mon-name(appname, monname): $appname + "-mon-" + $monname
components:
-
name: lb-comp
type: stlb::lb
description: Uses the default lb StyleBook to build the typical lb configuration objects
properties-default-sources:
- $parameters
-
name: monitors-comp
type: cmtypes::monitor
condition: $parameters.monitors
repeat: $parameters.monitors
repeat-item: mon
repeat-index: ndx
description: Builds a list of NetScaler monitor objects and binds them to the servicegroup of this LB config
properties-default-sources:
- $mon
properties:
monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
components:
-
name: monitor-svcg-binding-comp
condition: $parameters.svc-servers
type: ns::servicegroup_lbmonitor_binding
properties:
servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
monitor_name: $parent.properties.monitorname
<!--NeedCopy-->