StyleBookの設定
ご意見をお寄せいただきありがとうございました

この記事は機械翻訳されています.免責事項

NetScalerインスタンスをデータソースとして使用

管理対象のNetScalerインスタンスをデータソースとして使用できます。managed-adcは、NetScaler Consoleでデータソースとしてすぐに使用できる組み込みのデータソースタイプです。NetScaler Console内の各管理対象NetScalerインスタンスは、デフォルトでデータソースです。設定パックの作成時にNetScaler Consoleによって管理されている既存のNetScalerからデータが必要な場合は、StyleBookでこれらのデータソースの使用を開始できます。

StyleBookの定義では、datum組み込みタイプパラメータを指定します。StyleBookでデータソースタイプを使用できます。StyleBookユーザーは、そのソースからデータを取得するために使用できるデータソースを選択できます。

組み込みデータソースのコレクションなしでの使用

parameters: - name: selected-adc label: Select an existing NetScaler type: datum required: true data-source: type: managed-adc

この例では、datumパラメータを使用して、NetScaler Consoleによって管理されている任意のNetScalerインスタンスを選択します。managed-adc組み込みデータソースを使用すると、NetScaler Consoleによって管理されている任意のNetScalerインスタンスからデータを取得できます。

StyleBookでは、選択したNetScalerインスタンスから任意の構成にアクセスできます。また、その構成を使用して、同じNetScalerまたは別のNetScalerインスタンスで構成を作成または更新できます。これは、選択したターゲットNetScalerインスタンスによって異なります。

データソースからのコレクションへのアクセス:

選択したNetScalerインスタンスでコレクションにアクセスするには、次の式を使用します。

$parameters.selected-adc.collections.<collection-name>

例:

$parameters.selected-adc.collections.lbvserver

この式は、選択したNetScalerインスタンス上のlbvserverエンティティのリストを返します。たとえば、このリストを反復処理して、特定の条件を満たす特定のlbvserverを選択できます。

コレクションなしのStyleBookの例

name: add-vservers-from-managed-adc-instances namespace: com.citrix.adc.stylebooks version: "1.0" schema-version: "1.0" import-stylebooks: - namespace: netscaler.nitro.config prefix: ns version: "10.5" parameters: - name: selected-adc label: Select a NetScaler instance type: datum required: true data-source: type: "managed-adc" components: - name: sslvserver-comp type: ns::sslvserver repeat: $parameters.selected-adc.collections.lbvserver repeat-item: lbvs repeat-condition: $lbvs.attributes.servicetype == "SSL" properties: name: $lbvs.attributes.name ssl2: DISABLED ssl3: DISABLED tls1: DISABLED tls11: ENABLED tls12: ENABLED

設定パックGUIには、NetScaler Consoleによって管理されているNetScalerインスタンスが表示され、StyleBookユーザーは設定パックの作成または更新時に任意のNetScalerを選択できます。

コレクションなしの組み込みNetScalerデータソース

このStyleBookは、選択したNetScalerを使用し、すべてのlbvserverエンティティを反復処理します。SSL仮想サーバーを選択し、各仮想サーバーで許可されたSSLプロトコルバージョンを設定します。

次の式を使用すると、NetScalerインスタンス内のlbvserverエンティティのリストを反復処理できます。

repeat: $parameters.selected-adc.collections.lbvserver

この式では:

  • collections: NetScalerインスタンス上のすべてのエンティティタイプを指します。例: csvserverlbmonitorservicegroupなど
  • lbvserver: NetScalerインスタンス内のロードバランシング仮想サーバーエンティティのリストを指します

組み込みデータソースのコレクションありでの使用

parameters: - name: selected-lbvserver label: Select an existing lbvserver type: datum required: true data-source: type: managed-adc collection: lbvserver

この例では、datumパラメータを使用して、ユーザーがNetScalerインスタンスと、managed-adcデータソースタイプから特定のlbvserverの両方を選択できるようにします。

parametersセクションでコレクションタイプを定義すると、StyleBookユーザーはNetScalerインスタンスと、そのインスタンス上のコレクションから特定のエンティティを選択できます。

コレクションありの組み込みインスタンスデータソース

選択したアイテムの属性へのアクセス:

StyleBookユーザーが仮想サーバーを選択すると、StyleBook内の次の式で選択したアイテムの任意の属性にアクセスできます。

$parameters.selected-lbvserver.attributes.<attribute-name>

この例では、選択したdatumlbvserverです。したがって、nameservicetypeipv46など、NetScalerエンティティlbvserverの任意の属性にアクセスできます。

例:

$parameters.selected-lbvserver.attributes.ipv46

この式は、選択したロードバランシング仮想サーバーのIPを取得します。NetScalerエンティティ(コレクション)とその属性の詳細については、「NetScaler NITRO APIリファレンス」を参照してください。

コレクションから複数のアイテムを選択:

次のparametersセクションでは、StyleBookユーザーがコレクションの複数のアイテムを選択できるようにします。

parameters: - name: selected-lbvservers label: Select existing lbvservers type: datum[] required: true data-source: type: managed-adc collection: lbvserver

この例では、datumパラメータはデータソース配列を定義するために使用されます。ユーザーは、単一のNetScalerインスタンスから、または複数のNetScalerインスタンスにわたって、1つ以上のlbvserverを選択できます。

以下のコードスニペットは、選択したアイテムとその属性にアクセスする方法を示しています。

components: - name: sslvserver-comp type: ns::sslvserver repeat: repeat-list: $parameters.selected-lbvservers repeat-item: vserverObj properties: name: $vserverObj.attributes.name ssl2: DISABLED ssl3: DISABLED tls1: DISABLED tls11: ENABLED tls12: ENABLED

選択したアイテムの参照によるコレクションへのアクセス:

StyleBookユーザーが管理対象のNetScalerインスタンス上の特定のエンティティを選択できるようにするだけでなく、選択したNetScalerインスタンス上の同じまたは異なるコレクションから任意のエンティティにアクセスすることもできます。そのNetScalerインスタンス上の別のコレクションにアクセスするには、componentsセクションで次の式を使用します。

$parameters.selected-lbvserver.datasource.collections.<collection-name>

例:

$parameters.selected-lbvserver.datasource.collections.csvserver

この式は、選択したNetScalerインスタンスからコンテンツスイッチング仮想サーバーのリストを返します。

また、次の式は、lbvserverservicegroup間のすべてのバインディングのリストを返します。

$parameters.selected-lbvserver.datasource.collections.lbvserver_servicegroup_binding

コレクションありのStyleBookの例

以下は、管理対象のNetScalerインスタンスをデータソースとして使用する方法を示すStyleBookの例です。

name: bind-lb-to-servicegroup-using-ADC-as-datasource namespace: com.citrix.adc.stylebooks version: "1.1" display-name: "HTTP/SSL LoadBalancing StyleBook with Service Binding" description: "このStyleBookは、ユーザーがdatumタイプパラメータを使用してNetScaler上の既存のlbvserverを選択できるようにする、典型的なロードバランシングアプリケーション構成を定義します。次に、選択したlbのサービスグループがNetScaler上に存在しない場合は作成されます。最後に、選択したlbvserverがサービスにバインドされます。" schema-version: "1.0" import-stylebooks: - namespace: netscaler.nitro.config prefix: ns version: "10.5" parameters: - name: selected-vserver label: "Select an Existing VServer" description: "Load Balancing Application Vservers to be bound to service on the ADC" type: datum required: true data-source: type: managed-adc collection: lbvserver components: - name: servicegroup-discovery-comp type: object repeat: $parameters.selected-vserver.datasource.collections.servicegroup repeat-item: svcgrp repeat-condition: $svcgrp.attributes.servicegroupname == $parameters.selected-vserver.attributes.name + "-svcgrp" properties: servicegroupname: $svcgrp.attributes.servicegroupname - name: servicegroup-creation-if-not-exists-comp type: ns::servicegroup condition: not exists($components.servicegroup-discovery-comp) properties: servicegroupname: $parameters.selected-vserver.attributes.name + "-svcgrp" servicetype: $parameters.selected-vserver.attributes.servicetype components: - name: lbvserver-servicegroup-binding type: ns::lbvserver_servicegroup_binding properties: name: $parameters.selected-vserver.attributes.name servicegroupname: $parent.properties.servicegroupname

このStyleBookでは、componentsセクションは、選択したロードバランシング仮想サーバー名とsvcgrpを連結したサービスグループ名をチェックします。

選択したロードバランシング仮想サーバーの名前がlbv1の場合、このStyleBookはlbv1-svcgrpという名前のサービスグループをチェックします。見つからない場合は、lbv1-svcgrpというサービスグループを作成し、lbv1仮想サーバーにバインドします。

次の式は、NetScalerインスタンス内のサービスグループのリストを取得します。

repeat: $parameters.selected-vserver.datasource.collections.servicegroup

この式では:

  • datasource: NetScaler Consoleによって管理されている選択したNetScalerインスタンスを指します
  • collections: NetScalerインスタンス内のすべてのエンティティを指します
  • servicegroup: NetScalerインスタンス内のサービスグループを指します

コレクションデータのフィルタリング:

次のparametersセクションでは、StyleBook定義で組み込みデータソースコレクションにフィルタを指定する方法を説明します。これにより、StyleBookユーザーはフィルタリングされたコレクションから特定のアイテムを選択できます。

parameters: - name: selected-lbvserver label: Select an existing lbvserver type: datum required: true data-source: type: managed-adc collection: lbvserver collection-filters: protocol: SSL

この例では、datumパラメータは、ユーザーがNetScalerインスタンスと、managed-adcデータソースタイプからSSLプロトコルを持つ特定のlbvserverの両方を選択できるようにするために使用されます。

StyleBookユーザーが仮想サーバーを選択した後、選択したアイテムの任意の属性は、前のセクションで説明したのと同じ方法でアクセスできます。

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