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

February 6, 2024

寄稿者:

NetScaler Application Delivery Management（ADM）では、構成パックは常に作成元StyleBookにバインドされます。構成パックへの更新は、構成パックがバインドされているStyleBookでのみ実行できます。NetScaler ADMでは、既存の構成パックを新しいStyleBookに移行できるようになりました。新しいStyleBookは、構成パックにバインドされている現在のStyleBookのよりオリジナルバージョンにすることができます。または、構成パックをまったく異なるStyleBookに移行することもできます。

たとえば、 example-lbというStyleBookを作成しました。このStyleBookは、NetScaler ADC インスタンスに基本的なロードバランサー構成を展開するために使用されます。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 ADC インスタンスにデプロイされた既存の構成は、影響を受けません。

構成パックの移行

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

NetScaler ADM で、［ アプリケーション ］>［構成］に移動します。[ 構成 ] ページには、システム内に存在するすべての構成パックが表示されます。
下にスクロールして、 以前に作成した例の lb 構成パックを探し、[ Configpack の移行] をクリックします。
［移行対象のStyleBookの選択 ］ページが開き、Citrix ADM で使用可能なすべてのStyleBookが一覧表示されます。 下にスクロールしてexample-lb-monStyleBookを探し、「StyleBookを選択」をクリックします。example-lb-mon と入力してStyleBookを検索することもできます。

あるStyleBookから別のStyleBookに移行すると、2つのStyleBookのすべてのパラメーターが同じ構造にならない場合があります。パラメータ構造が類似している場合、以前の値はパラメータフィールドに自動的に保持されます。新しいStyleBookの一部のパラメーターは、新しいものであるか、構造が変更されている可能性があります。このような場合は、StyleBookパラメータの値を手動で入力する必要があります。たとえば、次の画像は example-lb StyleBookのパラメーターを示しています。

次の図は、構成パックを example-lb-mon StyleBook に移行した後のパラメータを示しています。

この場合、StyleBookは基本的なロードバランサー構成の古い値を保持していることがわかります。ただし、モニターパラメーターの値は手動で入力する必要があります。
インスタンスでモニターを作成する際に使用する新しいパラメータの値を入力します。
[ ターゲットインスタンス] で、構成を実行するCitrix ADC インスタンスのIPアドレスをクリックして選択します。必要な数のターゲットインスタンスを指定することで、構成を複数のCitrix ADCに展開できることに注意してください。
[ ドライラン] をクリックします。 オブジェクトページには、Citrix ADC インスタンスから新たに作成、変更、または削除されるオブジェクトが表示されます。
「作成」(Create) をクリックして、選択したインスタンスの設定を作成または更新します。ターゲットインスタンスが新しい場合は、構成パックが作成されます。それ以外の場合は、インスタンスにデプロイされた既存の設定が更新されます。

注

：更新アイコンをクリックして、最近検出されたCitrix ADC インスタンスを追加することもできます。そのため、これらのインスタンスは、このウィンドウのインスタンス一覧ですぐに表示されます。更新アイコンは現在、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
 

あなたの参考のために、 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 Citrix ADC 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
 

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

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

February 6, 2024

寄稿者:

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

構成パックの移行

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

StyleBook を構築する

この記事の概要