This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
負荷分散仮想サーバーを作成するStyleBook
この例で設計する基本的なStyleBookでは、プロトコルのタイプがHTTPで、ポート80でリッスンする負荷分散仮想サーバーを作成します。仮想サーバーの名前、IPアドレス、負荷分散方式の各パラメーターには、ユーザーが定義した値を指定できます（これらはStyleBookのパラメーターです）。
ヘッダー
StyleBookの先頭の6行は、Headerセクションです。この例の場合、Headerセクションは、次のように記述されています。
name: lb-vserver
description: This StyleBook defines a load balancing virtual server configuration.
display-name: Load Balancing Virtual Server (HTTP)
namespace: com.example.stylebooks
schema-version: "1.0"
version: "0.1"
<!--NeedCopy-->
Headerセクションには、次の情報が記述されています。
-
name：このStyleBookの名前。
-
description：このStyleBookの実行内容を示す説明。この説明は、Citrix ADM に表示されます。
-
表示名：Citrix ADM に表示されるスタイルブックの説明的な名前。
-
namespace：名前空間は、StyleBookの一意の識別子の一部で、これにより名前の衝突を回避できます。
-
schema-version：このリリースでは、値は常に「1.0」です。
-
version：StyleBookのバージョン番号。バージョン番号は、StyleBookの更新時に変更できます。
name、namespace、およびversionの組み合わせにより、システム内でStyleBookが一意に識別されます。Citrix ADM では、名前、名前空間、およびバージョンの同じ組み合わせを持つ2つのStyleBookを使用することはできません。ただし、nameとversionが同じであってもnamespaceが異なる場合、またはnamespaceとversionが同じであってもnameが異なる場合は、それらの2つのStyleBookを使用できます。
注
StyleBookを更新して、versionの番号が更新された場合を想定してください。別のStyleBookでこのStyleBookを参照している（つまりインポートしている）場合は、インポート元のStyleBookの正しいバージョン番号が使用されるように、別のStyleBookを確実に更新して、インポートされるStyleBookの正しいバージョンが使われるようにしてください。
StyleBookのインポート
ヘッダーの次のセクションは「import-stylebooks」と呼ばれます。このセクションで、現在のStyleBookで参照する他のStyleBookの名前空間とバージョン番号を宣言する必要があります。このセクションを記述すると、他のStyleBookをインポートして再利用できるため、StyleBookで同じ構成を再作成する必要がなくなります。
この例の場合、import-stylebooksセクションは、次のように記述されています。
import-stylebooks:
-
namespace: netscaler.nitro.config
prefix: ns
version: "10.5"
<!--NeedCopy-->
いずれかのNITRO構成オブジェクトを直接使用する場合、StyleBookでは、netscaler.nitro.config名前空間を必ず参照する必要があります。この名前空間には、LBVServerなど、すべてのCitrix ADC NITRO タイプが含まれています。ソフトウェアバージョン10.5以降がサポートされるため、StyleBookを使用して、リリース10.5以降を実行するすべてのCitrix ADCインスタンス上で構成を作成および実行できます。
import-stylebooksセクションで使用されるプレフィックスは、名前空間とバージョンの組み合わせを示すための略語です。この場合、nsはバージョン10.5のnetscaler.nitro.configを指します。StyleBookの以降のセクションでは、名前空間とバージョンを使用して、インポートされるStyleBookを示す代わりに、選択したプレフィックス文字列（上記の例ではns）を使用できます。
スタイルブックで使用されるバージョンは、Citrix ADC NITRO バージョンです。NitroバージョンXに基づくStyleBookを使用して、バージョンX以上のCitrix ADC を構成できます。
注
StyleBookを使用してバージョン10.5以降のCitrix ADC インスタンスを構成できるようにするには、互換性を最大限に高めるために、Nitro組み込みのStyleBookを直接使用するStyleBookにNitro 10.5名前空間をインポートすることをお勧めします（名前空間：netscaler.nitro.config、バージョン：10.5）。
他のStyleBookをインポートするStyleBookは、インポートするStyleBookと同じかそれ以上のバージョンのNitroバージョンに基づいている必要があります。たとえば、Nitro バージョン 10.5 に基づくStyleBookは、11.1 に基づくStyleBookに依存したり、使用したり、インポートしたりすることはできません。しかし、バージョン11.1に基づくStyleBookは、11.1未満のバージョンに基づくStyleBookをインポートすることができます。
また、Nitro名前空間をまったくインポートしないStyleBookも可能性もあります。つまり、StyleBookはNitroコンポーネントを直接定義する必要はなく、Nitroコンポーネントを定義するStyleBookをインポートできます。他のStyleBookをインポートするStyleBookは、依存関係の階層内で常に最も高いNitroバージョンを取得するため、そのバージョン以上のCitrix ADCを構成するために使用できます。
パラメーター
Parametersセクションでは、StyleBookで必要なすべてのパラメーターを宣言できます。StyleBookの作成者は、StyleBookのユーザーが指定する入力項目を決定する必要があります。この例の場合、ユーザーが、仮想サーバーの名前、IPアドレス、負荷分散方式を指定するようにStyleBookを設計しました。
Parametersセクションは、次のようになっています。
parameters:
-
name: name
type: string
label: Application Name
description: Name of the application configuration.
required: true
-
name: ip
type: ipaddress
label: Application Virtual IP (VIP)
description: Application VIP that the clients access.
required: true
-
name: lb-alg
type: string
label: LoadBalancing Algorithm
description: Choose the load balancing algorithm (method) used for load balancing client request between the application servers.
allowed-values:
- ROUNDROBIN
- LEASTCONNECTION
default: ROUNDROBIN
<!--NeedCopy-->
注
パラメーターのラベルを指定しない場合、Citrix ADM はこのパラメーターの表示時に name 属性を使用します。Citrix ADM での表示方法を制御できるように、パラメーターのラベルを常に定義する必要があります。
ただし、APIで使われる場合、パラメーターはそのnameで指定されます。
このセクションでは、name属性の値で示される3つのパラメーターが宣言されています。nameは仮想サーバー名、ipは仮想サーバーのIPアドレス、lb-algは負荷分散方式を表します。
-
type。これらのパラメータが取ることができる値のタイプ。たとえば、nameとlb-algには、文字列値を使用できます。また、ip値のタイプは、IPアドレスにする必要があります。StyleBookのパラメーターには、次のいずれかの組み込みタイプを指定できます。
-
文字列。文字の配列。長さが指定されていない場合、文字列値には、任意の数の文字を使用できます。ただし、min-length属性とmax-length属性を使用すれば、文字列タイプの長さを制限できます。
-
番号。整数。min-value属性とmax-value属性により、このタイプで使用できる最小数と最大数を指定できます。
-
ブール値。trueまたはfalseのいずれかになります。YAMLでは、すべてのリテラルがブール値（例：YesまたはNo）と見なされることに注意してください。
-
IPアドレス。有効な IPv4 または IPv6 アドレスを表すストリング。
-
tcp ポートです。TCP ポートまたは UDP ポートを表す 0 ～ 65535 の数値。
-
password. 不透明/秘密の文字列値。Citrix ADM でこのパラメータの値が表示される場合は、アスタリスク（*****）として表示されます。
-
certファイル。証明書ファイル。
-
キーファイル。証明書の秘密キーファイル。
-
ファイル。このタイプのパラメータでは、証明書やキーファイルなどのファイルをアップロードする必要があります。
-
オブジェクト。複数の要素で構成され、これらの各要素はパラメータです。このタイプを使用すると、関連する複数のパラメーターを1つの親パラメーターの下にグループ化できます。
-
必須です。パラメータが必須かオプションかを示します。trueに設定すると、パラメーターは必須になります。その場合、ユーザーは、StyleBookを使った構成の作成時にこのパラメーターの値を指定する必要があります。デフォルトでは、すべてのパラメーターが任意です。この例では、 name と ip は必須のパラメータで、 lb-alg はオプションのパラメータです。デフォルト値は「ROUNDROBIN.「
任意のパラメーターにデフォルト値を割り当てるには、default属性を使用します。構成の作成時、ユーザーが値を指定しない場合は、デフォルト値が使用されます。たとえば、lb-algパラメーターのデフォルト値は、ROUNDROBINです。
構成の作成時にユーザーが選択できる値を定義するには、allowed-values属性を使用します。この例の場合、lb-algパラメーターには、ROUNDROBINおよびLEASTCONNECTIONという2つの値が指定されています。
StyleBookをインポートして使用すると、Citrix ADM はこれらの3つのパラメータを含むフォームが表示されます。nameおよびipに対して表示されるフィールドでは、文字列タイプとIPアドレスタイプの値を入力できます。lb-algのフィールドは、ボックスの一覧として表示されます。デフォルトでは、ROUNDROBINという値が選択されています。
注
組み込みタイプに加えて、パラメーターには他のStyleBookをタイプにすることができます。こうして他のStyleBookで定義されたパラメーターを再利用できます。
コンポーネント
このStyleBookの最後のセクションは、Componentsセクションです。Componentsセクションは、StyleBookで最も重要なセクションです。このセクションでは、StyleBookで作成する必要がある構成オブジェクトを定義します。
この例の場合、Componentsセクションは、次のように記述する必要があります。
components:
-
name: lbvserver-comp
type: ns::lbvserver
properties:
name: $parameters.name
servicetype: HTTP
ipv46: $parameters.ip
port: 80
lbmethod: $parameters.lb-alg
<!--NeedCopy-->
この例では、コンポーネントが1つのみ含まれています。コンポーネントの主要な属性は、name、type、およびpropertiesです。このコンポーネントで指定するプロパティは、コンポーネントのタイプによって決まります。コンポーネントには、次の 2 つのタイプがあります。
-
内蔵タイプ。このタイプはシステムによって提供され、NITRO エンティティタイプ「lbvserver」や「servicegroup」など、定義する必要はありません。この例では、組み込みのコンポーネントのタイプが使われています。
-
複合タイプ。このタイプは、作成してCitrix ADMにインポートしたスタイルブック、またはCitrix ADMに同梱されているデフォルトのスタイルブックです。複合StyleBookについて詳しくは、複合スタイルブックの作成を参照してください。
この例では、 lbvserver-compというコンポーネントを定義しました。このコンポーネントの種類は ns። lbvserver(組み込みのニトロ型) です。ここで、「ns」は、インポートスタイルブックセクションで指定した名前空間 netscaler.nitro.config およびバージョン10.5を参照する接頭辞で、「lbvserver」はこの名前空間のNitroリソースです。
ここで定義されているpropertiesは、「lbvserver」リソースの属性です。使用可能なすべての Citrix ADC Nitro リソースとその属性について詳しくは、Citrix ADC NITRO REST API ドキュメントを参照してください。
このセクションのプロパティには、「lbvserver」リソースの必須属性が含まれています。そのため、これらの属性の値を指定できます。この例では、servicetypeとportには静的な値が指定されていますが、name、ipv46、およびlbmethodの各プロパティは、入力パラメーターから値を取得します。StyleBookの残りの部分では、 を使用して、パラメータ・セクションで定義されたパラメータ名を参照できます。 $parameters.<parameter-name>式 (例: $パラメータ.ip) です。
注
慣例により、プリフィックス「ns」は、Citrix ADC Nitro 名前空間を「import-stylebooks」セクションで指定するために常に使用されます。これは必須ではありませんが、一貫性を保つためにお使いのStyleBookで慣例に従うことをお勧めします。
スタイルブックを構築する
StyleBookの必須セクションをすべて定義しました。これらのセクションをまとめて、最初のStyleBookを作成します。StyleBookの内容をコピーして、テキストエディターに貼り付け、lb-vserver.yamlという名前でファイルを保存します。StyleBooksで組み込みのYAMLバリデータを使用して、YAMLコンテンツを検証およびインポートすることをお勧めします。
lb-vserver.yamlファイルのすべての内容を次に示します。
name: lb-vserver
namespace: com.example.stylebook
version: "1.0"
display-name: Load Balancing Virtual Server (HTTP)
description: "This stylebook defines a very simple load balancing HTTP virtual server configuration"
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "10.5"
prefix: ns
-
namespace: com.citrix.adc.stylebooks
version: "1.0"
prefix: stlb
parameters:
-
name: name
label: "Application Name"
description: "Give a name to the application configuration."
type: string
required: true
-
name: vip-ipaddress
label: "Load Balancer IP Address"
description: "The Application VIP that clients access"
type: ipaddress
required: true
-
name: lb-alg
label: LB Algorithm
description: Load Balancing Algorithm
type: string
default: ROUNDROBIN
allowed-values:
- ROUNDROBIN
- LEAST-CONNECTION
components:
-
name: lbvserver-comp
description: This StyleBook component (a Builtin Nitro StyleBook) builds a Citrix ADC load balancing virtual server configuration object.
type: ns::lbvserver
properties:
name: $parameters.name
ipv46: $parameters.vip-ipaddress
lbmethod: $parameters.lb-alg
servicetype: HTTP
port: 80
<!--NeedCopy-->
StyleBookを使用して構成を作成するには、Citrix ADM にインポートしてから使用する必要があります。詳しくは、「ユーザー定義スタイルブックの使用方法」を参照してください。
またこのStyleBookを他のStyleBookに（import-stylebooks構造を使って）インポートすることもできます。または、次のセクションで説明されるように、より多くのパラメーターとコンポーネントを含むようにこのStyleBookを修正することもできます。
共有
共有
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select Do Not Agree to exit.