ファイルをアップロードするためのStyleBookを作成する
NetScaler Console StyleBookを使用すると、NetScaler Console GUIまたはAPIを使用して、ローカルファイルシステムからNetScalerインスタンスにあらゆる種類のファイルをアップロードする際に、NetScaler構成を作成できます。これらのファイルは、証明書ファイルや地理位置情報ファイルなどの例です。これらのファイルをアップロードするディレクトリを指定することもできます。
StyleBook構成
以下は、NetScalerインスタンスに地理位置情報ファイルをアップロードする方法を説明する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 NetScaler
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 NetScaler Console
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)
注
この例で使用されているパラメータはファイルタイプです。このStyleBookをNetScaler Consoleにインポートして、地理位置情報ファイルをアップロードするために使用できます。
このStyleBookでは、ファイルがNetScaler Consoleにすでに存在している必要があります（たとえば、SCPのようなユーティリティを使用してNetScaler Consoleにすでにコピーしている場合など）。 NetScaler Consoleファイルシステムに最初にコピーせずに、NetScaler Consoleを介してNetScalerにファイルをアップロードしたい場合は、2つの「string」パラメータを持つStyleBookを作成できます。1つはNetScalerで使用するファイル名を指定するためのもので、もう1つはファイルの内容を指定するためのものです。これらの2つのパラメータをupload-file-compコンポーネントで使用します。以下は、地理位置情報ファイルをアップロードするための代替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 NetScaler
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 NetScaler
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/NetScaler/inbuilt_db/"
filecontent: base64.encode($parameters.filecontents)
ファイルをアップロードするための構成を作成する
次の手順では、上記で説明した最初のStyleBookを使用して地理位置情報ファイルをアップロードする、選択したNetScalerインスタンス上の構成を作成します。
ファイルをアップロードするための構成を作成するには：
-
NetScaler Consoleで、Applications > Configuration に移動し、Create New をクリックします。「Choose StyleBook」ページには、NetScaler Consoleで利用可能なすべてのStyleBookが表示されます。下にスクロールして、インポートしたStyleBookを選択します。StyleBookパラメータは、このStyleBookで定義されているすべてのパラメータの値を入力できるユーザーインターフェイスページとして表示されます。
-
基本ロードバランサー設定セクションで、ロードバランサーの名前と仮想IPアドレスを入力します。
-
「場所ファイル」セクションで、ファイルの名前または場所を入力します。「注」NetScaler Consoleでは、ファイルが現在のテナントのフォルダーの下にのみ配置されていることを確認してください。任意のFTPを使用して、ファイルをNetScaler Consoleファイルシステムにコピーします。
-
ターゲットインスタンスにアクセスする前に、ユーザー資格情報の提供を求められる場合があります。
-
構成を作成する必要があるターゲットのNetScalerインスタンスを選択し、「作成」をクリックします。
「注」
Citrixは、インスタンスで実際の構成を実行する前に、ターゲットインスタンスで作成される構成オブジェクトを確認するために「ドライラン」を選択することを推奨します。
構成パックの作成が成功すると、ファイルはNetScalerインスタンスのファイルシステム上の次の場所に保存されます: /var/netscaler/inbuilt_db/
「注」
更新アイコンをクリックして、NetScaler Consoleで最近検出されたNetScalerインスタンスを、このウィンドウで利用可能なインスタンスのリストに追加することもできます。
NetScaler Console APIを使用して構成パックを作成する
選択したNetScalerインスタンスにファイルをアップロードする構成パックを作成するために、NetScaler Console APIを使用することもできます。APIの使用方法の詳細については、「任意のファイルタイプをアップロードする構成を作成するためのAPIの使用方法」を参照してください。