StyleBookの構成パックを別のStyleBookに移行する
NetScaler Application Delivery Management（ADM）では、構成パックは常に作成元StyleBookにバインドされます。構成パックへの更新は、構成パックがバインドされているStyleBookでのみ実行できます。NetScaler ADMでは、既存の構成パックを新しいStyleBookに移行できるようになりました。新しいStyleBookは、構成パックにバインドされている現在のStyleBookのよりオリジナルバージョンにすることができます。または、構成パックをまったく異なるStyleBookに移行することもできます。
たとえば、 example-lbというStyleBookを作成しました。このStyleBookは、NetScaler インスタンスに基本的なロードバランサー構成を展開するために使用されます。NetScaler ADCインスタンスで、このStyleBookから構成パックCP1を作成しました。その後、StyleBookに監視設定が含まれていないことに気付きました。 これで example-lb-mon というStyleBookが作成されました。このStyleBookには、example-lb StyleBookと同じロードバランサー設定がありますが、モニターを設定する機能が追加されています。
次に、構成パック CP1 で作成された既存の構成を更新して、いくつかのモニターを追加します。以前は、構成パック CP1 を削除し、新しい StyleBook から構成パック CP2 を作成して、構成にモニターを追加する必要がありました。CP1を削除すると、1つ以上のNetScaler ADCインスタンス上の構成パックCP1で作成されたすべての構成が削除されます。以前は、すべてのパラメータに値を入力して、新しいStyleBookで新しい構成パックを再作成する必要がありました。
代わりに、既存の構成パック CP1 を新しい example-lb-mon StyleBook に移行できるようになりました。新しいStyleBookでは、モニターモニターの詳細を設定できます。これらのモニター関連の設定オブジェクトのみが、構成パックが展開されたNetScaler ADCインスタンスに追加されます。あなたは今、モニタの詳細だけを提供する必要があります。変更されていないNetScalerインスタンスにデプロイされた既存の構成は、影響を受けません。
構成パックの移行
example-lb StyleBook を使用して作成した構成パックを example-lb-mon StyleBook に移行するには
-
NetScaler ADM で、［ アプリケーション ］>［ 構成］に移動します。[ 構成 ] ページには、システム内に存在するすべての構成パックが表示されます。
-
下にスクロールして、 以前に作成した例の lb 構成パックを探し、[ Configpack の移行] をクリックします。
-
［ 移行するターゲットStyleBookの選択 ］ページが開き、NetScaler ADMで使用可能なすべてのStyleBookが一覧表示されます。 下にスクロールしてexample-lb-monStyleBookを探し、「StyleBookを選択」をクリックします。example-lb-mon と入力してStyleBookを検索することもできます。
あるStyleBookから別のStyleBookに移行すると、2つのStyleBookのすべてのパラメーターが同じ構造にならない場合があります。パラメータ構造が類似している場合、以前の値はパラメータフィールドに自動的に保持されます。新しいStyleBookの一部のパラメーターは、新しいものであるか、構造が変更されている可能性があります。このような場合は、StyleBookパラメータの値を手動で入力する必要があります。たとえば、次の画像は example-lb StyleBookのパラメーターを示しています。
次の図は、構成パックを example-lb-mon StyleBook に移行した後のパラメータを示しています。
この場合、StyleBookは基本的なロードバランサー構成の古い値を保持していることがわかります。ただし、モニターパラメーターの値は手動で入力する必要があります。
-
インスタンスでモニターを作成する際に使用する新しいパラメータの値を入力します。
-
「 ターゲットインスタンス」で、構成を実行するNetScalerインスタンスのIPアドレスをクリックして選択します。必要な数のターゲットインスタンスを指定することで、複数のNetScalerに構成をデプロイできることに注意してください。
-
[ ドライラン] をクリックします。 オブジェクトページには 、NetScalerインスタンスから新規作成、変更、または削除されるオブジェクトが表示されます。
-
「 作成 」(Create) をクリックして、選択したインスタンスの設定を作成または更新します。ターゲットインスタンスが新しい場合は、構成パックが作成されます。それ以外の場合は、インスタンスにデプロイされた既存の設定が更新されます。
注：
更新アイコンをクリックして、最近検出されたNetScalerインスタンスを追加することもできます。そのため、これらのインスタンスは、このウィンドウのインスタンス一覧ですぐに表示されます。更新アイコンは現在、NetScaler ADM でのみ使用できます。
StyleBookの1つのバージョンから次のバージョンに構成パックを移行することもできます。また、新しいバージョンに存在する新しい必須パラメータの値を入力する必要があります。構成パックを古いバージョンのStyleBookに移行することもできます。この場合、古いStyleBookに存在しない余分なパラメータは削除されます。 オブジェクトページには 、構成から削除されたすべてのオブジェクトが表示されます。
移行が成功すると、ConfigPackは新しいStyleBookにバインドされます。
構成パックの名前と構成パック ID が以前と同じであることがわかります。しかし、NetScaler ADM は例-lbから例-lb-monにStyleBook名を更新します。
StyleBook を構築する
参考までに、 example-lbStyleBookの全コンテンツを以下に示します。
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-->