Application Delivery Management

StyleBookの構成パックを別のStyleBookに移行

NetScalerアプリケーション配信管理(ADM)では、構成パックは常に作成元のStyleBookにバインドされます。構成パックへの更新は、構成パックがバインドされているStyleBookを介してのみ実行できます。NetScaler ADM では、既存の構成パックを新しいStyleBookに移行できるようになりました。新しいStyleBookは、構成パックにバインドされている現在のStyleBookのよりオリジナルなバージョンにすることができます。または、構成パックをまったく別のStyleBookに移行することもできます。

たとえば、 example-lbというStyleBookを作成しました。このStyleBookは、NetScaler インスタンスに基本的なロードバランサー構成を展開するために使用されます。NetScalerインスタンスで、このStyleBookから構成パックCP1を作成しました。その後、StyleBookに監視設定が含まれていないことに気付きました。 これで example-lb-mon というStyleBookが作成されました。このStyleBookには、example-lb StyleBookと同じロードバランサー設定がありますが、モニターを設定する機能が追加されています。

次に、構成パックCP1で作成された既存の構成を更新して、いくつかのモニターを追加する必要があります。以前は、構成にモニターを追加するには、構成パックCP1を削除し、新しいStyleBookから構成パックCP2を作成する必要がありました。CP1を削除すると、1つ以上のNetScalerインスタンス上の構成パックCP1で作成されたすべての構成が削除されます。以前は、すべてのパラメーターに値を入力して、新しいStyleBookを使用して新しい構成パックを再作成する必要がありました。

代わりに、既存の構成パック CP1 を新しい example-lb-mon StyleBookに移行できるようになりました。新しいStyleBookでは、モニターモニターの詳細を設定できます。これらのモニター関連の構成オブジェクトのみが、構成パックが展開されたNetScalerインスタンスに追加されます。あなたは今、モニタの詳細だけを提供する必要があります。変更されていないNetScalerインスタンスにデプロイされた既存の構成は、影響を受けません。

構成パックを移行

example-lb StyleBook を使用して作成された構成パックを example-lb-mon StyleBook に移行するには

  1. NetScaler ADM で、[ アプリケーション ]>[ 構成]に移動します。 設定ページに、システムに存在するすべての構成パックが表示されます。

  2. 下にスクロールして、前に作成したはずの example-lb 構成パックを見つけ、「構成パックを移行」をクリックします。

  3. 移行するターゲット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は基本的なロードバランサー構成の古い値を保持していることがわかります。ただし、モニターパラメーターの値は手動で入力する必要があります。

  4. インスタンスでモニターを作成する際に使用する新しいパラメータの値を入力します。

  5. ターゲットインスタンス」で、構成を実行するNetScalerインスタンスのIPアドレスをクリックして選択します。必要な数のターゲットインスタンスを指定することで、複数のNetScalerに構成をデプロイできることに注意してください。

  6. [ ドライラン] をクリックします。 オブジェクトページには 、NetScalerインスタンスから新規作成、変更、または削除されるオブジェクトが表示されます。

  7. 作成 」(Create) をクリックして、選択したインスタンスの設定を作成または更新します。ターゲットインスタンスが新しい場合、構成パックが作成されます。それ以外の場合は、インスタンスにデプロイされた既存の設定が更新されます。

    注:

    更新アイコンをクリックして、最近検出されたNetScalerインスタンスを追加することもできます。そのため、これらのインスタンスは、このウィンドウのインスタンス一覧ですぐに表示されます。更新アイコンは現在、NetScaler ADM でのみ使用できます。

StyleBookのあるバージョンから次のバージョンに構成パックを移行することもできます。また、新しいバージョンに存在する新しい必須パラメータの値を入力する必要があります。構成パックを古いバージョンの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-->
StyleBookの構成パックを別のStyleBookに移行