StyleBookを作成してファイルをアップロードする
Citrix ADM StyleBooksを使用すると、Citrix ADM GUIまたはAPIを使用して、ローカルファイルシステムからCitrix ADCインスタンスにあらゆる種類のファイルをアップロードする際に、とりわけ含める可能性のあるCitrix ADC構成を作成できます。これらのファイルは、証明書ファイルの例でも位置情報ファイルでもかまいません。これらのファイルをアップロードするディレクトリを指定することもできます。
スタイルブックの設定
以下は、Citrix ADC インスタンスに位置情報ファイルをアップロードする方法を説明するStyleBookの例です。地理ファイルは、地理的位置に基づいて静的近接を定義するために、GSLB設定で通常使用されます。
StyleBookを構築する-1
name: upload-geolocations
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to Citrix ADC
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: locationfile
label: Location File
description: The system file path of the geolocation file on Citrix ADM
type: file
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.locationfile.filename
filelocation: "/var/netscaler/inbuilt_db/"
filecontent: base64.encode($parameters.locationfile.contents)
<!--NeedCopy-->
注:
この例で使用されているパラメータはタイプファイルのものです。このStyleBookをCitrix ADM にインポートして、ジオロケーションファイルをアップロードできます。
このStyleBookでは、ファイルがCitrix ADMにすでに存在している必要があります（たとえば、SCPなどのユーティリティを使用してCitrix ADMにコピー済みなど）。 Citrix ADMファイルシステムにファイルをコピーせずに、Citrix ADM経由でCitrix ADCにファイルをアップロードする場合は、2つの「文字列」パラメータを持つStyleBookを構築できます。1つはCitrix ADCで使用するファイル名を指定し、もう1つはCitrix ADCの内容を指定するものです。ファイルを作成し、upload-file-comp コンポーネントでこれら 2 つのパラメータを使用します。以下は、位置情報ファイルをアップロードするための代替StyleBookです。
StyleBookを構築する-2
name: upload-geolocations-alt
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to Citrix ADC
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: filename
label: Location Filename
description: The name of the location file on the Citrix ADC
type: string
required: true
-
name: filecontents
label: Location File Contents
description: The contents of the location file
type: string
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.filename
filelocation: "/var/Citrix ADC/inbuilt_db/"
filecontent: base64.encode($parameters.filecontents)
<!--NeedCopy-->
ファイルをアップロードするための構成の作成
以下の手順では、選択したCitrix ADCインスタンスに、上記の最初のStyleBookを使用して位置情報ファイルをアップロードする構成を作成します。
ファイルをアップロードするための設定を作成するには：
-
Citrix ADM で、［ アプリケーション ］>［ 構成］に移動し、［ 新規作成］をクリックします。「スタイルブックの選択」ページには、Citrix ADM で使用できるすべてのスタイルブックが表示されます。下方向にスクロールして、インポートしたStyleBookを選択します。
StyleBookパラメーターは、このStyleBookで定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして表示されます。
-
ロードバランサーの基本設定セクションにロードバランサーの名前と仮想 IP アドレスを入力します。
- [ ロケーションファイル ] セクションで、ファイルの名前または場所を入力します。
注：
Citrix ADM では、ファイルが現在のテナントのフォルダーにのみ配置されていることを確認します。任意のFTPを使用してファイルをCitrix ADMファイルシステムにコピーします。
-
ターゲットインスタンスにアクセスする前に、ユーザー認証情報を入力するように求められる場合があります。
- 構成を作成する対象のCitrix ADC インスタンスを選択し、［ 作成］をクリックします。
注：
インスタンスで実際の構成を実行する前に、［Dry Run ］を選択して、ターゲットインスタンスに作成された構成オブジェクトを確認することをお勧めします。
構成パックが正常に作成されると、ファイルはCitrix ADCインスタンスファイルシステムの /var/netscaler/inbuilt_db/ という場所に保存されます。
注
更新アイコンをクリックして、Citrix ADMで最近検出されたCitrix ADCインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。
Citrix ADM APIを使用した構成パックの作成
Citrix ADM APIを使用して、選択したCitrix ADCインスタンスにファイルをアップロードする構成パックを作成することもできます。API の使用方法の詳細については、「 API を使用して任意のファイルタイプをアップロードする構成を作成する方法」を参照してください。