設定パックを作成および編集する
NetScaler® Application Delivery Management (ADM) では、StyleBook から設定パックを作成できます。設定パックは、作成元の StyleBook に関連付けられています。設定パックへの更新は、関連付けられている StyleBook を介して行われます。
Related information
設定パックを作成する
StyleBook から設定パックを作成するには、次の手順を実行します。
-
Applications > StyleBooks > Configurations の順に移動します。
-
Add をクリックします。
-
Choose StyleBooks で、設定パックを作成する必要な StyleBook を選択します。このページでは、StyleBook がデフォルトとカスタムの StyleBook に分類されています。必要な StyleBook を見つけるには、それぞれのタブを選択します。
-
アプリケーション名、IP アドレス、ポート、プロトコルタイプなどの必要な詳細を指定します。GUI フィールドは StyleBook ごとに異なります。
-
Target Instances で、構成を実行するインスタンスまたはインスタンスグループを選択します。注必要な数のターゲットインスタンスを指定することで、複数の NetScaler に構成を展開できます。
-
Dry Run をクリックします。Objects ページには、NetScaler インスタンスから作成、変更、または削除されるオブジェクトが表示されます。
-
「作成」をクリックします。構成パックは、StyleBook > Configurations ページに表示されます。
既存の構成パックを編集する場合は、構成パックを選択し、「編集」をクリックします。
構成パックのStyleBookを変更する
機能を追加したり、問題を修正したりするために、StyleBookを更新する必要がある場合があります。以前のStyleBookを使用して構成パックをすでに作成している場合は、新しい更新されたStyleBookを使用するようにそれらを更新したい場合があります。新しいStyleBookを使用するには、構成パックの既存のStyleBookを変更します。
例として、ADCインスタンスに基本的なロードバランサー構成を展開するStyleBook「example-lb」を考えてみましょう。そして、このStyleBookから構成パックCP1を作成します。
基本的なロードバランサー構成でモニターを構成したい場合は、新しいStyleBookが必要です。したがって、基本的なロードバランサー構成とともにモニターを構成する機能を含む「example-lb-mon」StyleBookを作成します。
StyleBookを作成したら、既存の構成パックCP1を更新してモニターを追加します。これを行うには、次の手順を実行します。
-
Applications > StyleBooks > Configurations に移動します。
-
StyleBookを変更する構成パックを選択します。この例では、リストからCP1を選択します。
-
「StyleBookの変更」をクリックします。
-
リストから必要なStyleBookを選択します。次に、「選択を保存」をクリックします。
-
「変更」をクリックします。この例では、リストから「example-lb-mon」を選択します。設定パックのStyleBookを変更すると、新しいStyleBookのパラメータは、既存のStyleBookとは異なる構造を持つ場合があります。パラメータ構造が以前のStyleBookと類似している場合、パラメータの値はそれぞれのフィールドに自動的に保持されます。そうでない場合、2つのStyleBook間で同じ構造を持つパラメータのみが転送されます。例えば、同じパラメータ名、タイプ、パラメータの親などです。
新しいStyleBookに新しい必須パラメータが追加された場合、StyleBookの変更後、それらのパラメータの値を手動で指定する必要があります。この例では、example-lb StyleBookの設定ページに表示されるパラメータは次のとおりです。
新しいexample-lb-mon StyleBookの設定ページに表示されるパラメータは次のとおりです。
この場合、新しいStyleBookは既存のパラメータを変更していないため、StyleBookは基本的なロードバランサー設定の古い値を保持します。そして、新しいパラメータのみを追加します。モニターパラメータについては、必要な値を手動で指定してください。 -
ターゲットインスタンスで、選択したインスタンスを確認し、必要に応じてリストを更新します。
-
ドライランをクリックします。オブジェクトページには、NetScalerインスタンスから作成、変更、または削除されるオブジェクトが表示されます。
-
OKをクリックします。StyleBook > 構成ページで、StyleBook名列には、選択した設定パックの新しいStyleBook名が表示されます。この場合、example-lb-monと表示されます。
複数の設定パックを持つStyleBookを変更する
複数の設定パックを持つ既存のStyleBookを変更する場合は、次の手順を実行します。
-
新しいStyleBookをADMにインポートします。通常、新しいStyleBookは、既存のStyleBookよりも高いバージョンで、同じ名前と名前空間を持ちます。ただし、名前、名前空間、またはバージョンが異なる場合は、この手順をスキップできます。
-
既存のStyleBookに関連付けられている構成パックのStyleBookを変更します。選択した構成パックが同じStyleBookに関連付けられている場合にのみ、StyleBookの変更を選択できます。同じStyleBookに関連付けられている構成パックを選択します(/en-us/netscaler-application-delivery-management-software/media/change-sb-multiple-citrix.png)選択した構成パックの場合、次の条件が満たされると、ADMはStyleBookを正常に変更します。
-
既存のStyleBookのすべての構成パラメータは、選択したStyleBookに存在する必要があります。
-
選択したStyleBookからの新しいパラメータはオプションです。
選択した構成パックの進行状況を確認するには、構成ページで進行中/失敗した構成を選択します。構成パックの進行状況(/en-us/netscaler-application-delivery-management-software/media/configuration-pack-progress-failed-citrix.png) -
-
すべての構成パックが新しいStyleBookに紐付けられたら、古いStyleBookをADMから削除します。
構成パックのエクスポートまたはインポート
StyleBookと同様に、構成パックをエクスポートまたはインポートできます。この機能を使用すると、StyleBook構成を別のADMサーバーに簡単に共有できます。構成パックをエクスポートすると、
tgzまたはzipバンドルがローカルコンピュータにダウンロードされます。このバンドルには、構成パックで定義されているすべてのパラメータを含むJSONファイルが含まれています。
構成のエクスポート
構成パックをエクスポートするには、次の手順を実行します。
-
「Applications > StyleBooks > Configurations」に移動します。
-
エクスポートする構成パックを選択します。
-
「Select Action」で「Export Configuration」を選択します。構成エクスポートオプション(/en-us/netscaler-application-delivery-management-software/media/export-configuration-pack-citrix.png)
-
「Export Configuration」ペインで、以下を指定します。
-
構成が展開されているターゲットインスタンスの情報: このオプションを選択すると、ターゲットインスタンスの情報がエクスポートバンドルに含まれます。
-
構成に関連付けられたStyleBook: このオプションを選択すると、StyleBookがエクスポートバンドルに含まれます。
-
エクスポート構成データを保護するためのパスフレーズ: エクスポートバンドルを暗号化するためのパスフレーズを指定します。このパスフレーズは、構成パックの機密データを保護します。
-
圧縮ファイルの種類: ZIPまたはTGZファイルの種類を選択します。
構成パックのエクスポート(/en-us/netscaler-application-delivery-management-software/media/export-configuration-options-citrix.png) -
-
「Export」をクリックします。エクスポートバンドルをローカルコンピューターに保存します。
構成のインポート
ローカルコンピューターから別のADMサーバーに構成パックをインポートできます。構成パックをインポートするには、次の手順を実行します。
-
「Applications > StyleBooks > Configurations」に移動します。
-
「設定のインポート」を選択します。設定のインポートオプション(/en-us/netscaler-application-delivery-management-software/media/import-configuration-citrix.png)
-
コンピューターからインポートファイルバンドルを選択します。
-
エクスポート時に指定したパスフレーズを使用します。
-
このオプションは、ADCインスタンスにすでに作成されているオブジェクトを変更しません。同じADCインスタンスを2つのADMサーバーに追加したとします。そして、あるADMサーバーから別のサーバーに構成パックを移行したいとします。このオプションを使用して、ADCインスタンス上の構成オブジェクトを変更せずに構成パックをインポートします。重要このオプションを使用するには、指定された構成バンドルにターゲットインスタンス情報が含まれていることを確認してください。構成のエクスポートを参照してください。このオプションは、すべてのオブジェクトがターゲットインスタンスに存在する場合にのみ、構成を移行します。
-
「インポート」をクリックします。
設定のインポート(/en-us/netscaler-application-delivery-management-software/media/import-configuration-options-citrix.png)
構成パックをインポートすると、ADMは次のことを検証します。
-
関連付けられたStyleBook: 関連付けられたStyleBookがADMにない場合、構成パックとともにStyleBookをインポートします。
-
ターゲットインスタンス: ターゲットインスタンスを確認し、指定されたターゲットインスタンスに構成を展開します。ADMに記載されているADCインスタンスがない場合、構成パックはターゲットインスタンスなしでインポートされます。
-
ソースADM：同じADMサーバーに構成パックをインポートする場合、選択したバンドルは既存の構成パックを更新します。
構成パックからターゲットインスタンスをデタッチする
構成パックからターゲットインスタンスをデタッチするには、次の手順を実行します。
-
アプリケーション > 設定 > 設定パック に移動します。
-
削除するターゲットインスタンスを含む構成パックを選択します。
-
Select Action で、Detach Targets を選択します。
-
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
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