Application Delivery Management

コンポーネント

StyleBookにおけるコンポーネントの構成は、StyleBookの中で最も重要なセクションと見なされます。このセクションでは、作成する必要がある構成オブジェクトを定義します。この構成を使用すると、同じタイプの構成オブジェクトを1つまたは複数構築できます。

コンポーネントの構成は、パラメーターセクションで提供される入力を使用して、StyleBookによって生成される構成を調整できます。これはオプションのセクションですが、ほとんどのStyleBookにはコンポーネントセクションがあります。

次の表は、コンポーネントの主要な属性について説明しています。

属性 説明
name コンポーネントの名前。英数字の名前を指定できます。名前はアルファベットで始まり、追加のアルファベット、数字、ハイフン (-)、またはアンダースコア (_) を含めることができます。
description StyleBookにおけるこのコンポーネントの役割の説明。
type このコンポーネントが提供するプロパティを決定するタイプ。コンポーネントには2種類のタイプがあります。組み込みタイプ: このタイプはシステムによって提供され、定義する必要はありません。たとえば、NITROエンティティタイプ「lbvserver」や「servicegroup」などです。コンポーネントが組み込みタイプ属性を持つ場合、NetScaler上にそのタイプの構成オブジェクトを作成します。たとえば、コンポーネントが組み込みタイプ「lbvserver」を参照する場合、このコンポーネントは構成のターゲットであるNetScalerインスタンス上に負荷分散仮想サーバーを作成します。複合タイプ: このタイプは、NetScaler ADMに作成およびインポートした既存のStyleBookを参照します。コンポーネントが複合タイプ属性を持つ場合、参照されるStyleBookで指定されたすべての構成オブジェクトを、構成のターゲットであるNetScalerインスタンス上に作成します。これにより、各StyleBookが最終構成の一部を作成する複数のStyleBookを組み合わせることができます。複合StyleBookの詳細については、「複合StyleBookの作成」を参照してください。
properties コンポーネントタイプ属性に使用できるサブ属性。コンポーネントに有効なプロパティは、そのタイプによって決定されます。組み込みタイプの場合、これらは対応するNitroオブジェクトのプロパティまたは属性です。タイプが別のStyleBookであるコンポーネント、つまり複合タイプの場合、プロパティはそのStyleBookで定義されたパラメーターに対応します。

:

components:
   -
     name: my-lbvserver-comp
     type: ns::lbvserver
     properties:
         name: $parameters.name
         servicetype: HTTP
         ipv46: $parameters.ip
         port: 80
         lbmethod: $parameters.lb-alg
<!--NeedCopy-->

この例では、my-lbvserver-compというコンポーネントを定義しました。このコンポーネントはns::lbvserverタイプ(組み込みタイプ)であり、「ns」はimport-stylebooksセクションで指定したネームスペースnetscaler.nitro.configおよびバージョン10.5を参照するプレフィックスであり、「lbvserver」はこのネームスペース内のNITROリソースです。

このセクションのプロパティには、「lbvserver」リソースの4つの必須属性と1つのオプション属性(lbmethod)が含まれており、これらの属性の値を指定できます。この例では、servicetypeとportに静的な値を指定し、name、ipv46、およびlbmethodプロパティは入力パラメーターから値を取得します。パラメーターセクションで定義されたパラメーター名は、$parameters.<name>表記を使用して参照します。たとえば、$parameters.ipです。

NITROリソースタイプ(そのコンポーネントプロパティ)の属性名には小文字を使用する必要があります。そうしないと、StyleBookのインポートが失敗します。

コンポーネント