NetScaler® ADMにファイルをアップロードするためのStyleBookを作成する
NetScaler Application Delivery Management (NetScaler ADM) StyleBookを使用すると、NetScaler ADM 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 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)
注
この例で使用されているパラメータはファイルタイプです。このStyleBookをNetScaler ADMにインポートして、地理位置情報ファイルをアップロードするために使用できます。
このStyleBookでは、ファイルがNetScaler ADMにすでに存在している必要があります（たとえば、scpのようなユーティリティを使用してNetScaler ADMにすでにコピーしている場合など）。 NetScaler ADMファイルシステムに最初にコピーせずにNetScaler ADMを介して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 ADMで、Applications > Configuration に移動し、Create New をクリックします。「Choose StyleBook」ページには、NetScaler ADMで利用可能なすべてのStyleBookが表示されます。下にスクロールして、インポートしたStyleBookを選択します。StyleBookパラメータは、このStyleBookで定義されているすべてのパラメータの値を入力できるユーザーインターフェイスページとして表示されます。
-
基本ロードバランサー設定セクションで、ロードバランサーの名前と仮想IPアドレスを入力します。
-
「Location File」セクションで、ファイルの名前または場所を入力します。注NetScaler ADMでは、ファイルが現在のテナントのフォルダーの下にのみ配置されていることを確認してください。任意のファイル転送プロトコルを使用して、ファイルをNetScaler ADMファイルシステムにコピーします。
-
ターゲットインスタンスにアクセスする前に、ユーザー資格情報の提供を求められる場合があります。
-
構成を作成する必要があるターゲットのNetScalerインスタンスを選択し、作成をクリックします。
注
Citrixでは、インスタンスで実際の構成を実行する前に、ターゲットインスタンスで作成される構成オブジェクトを確認するためにドライランを選択することをお勧めします。
構成パックの作成が成功すると、ファイルはNetScalerインスタンスのファイルシステム上の次の場所に保存されます: /var/netscaler/inbuilt_db/
注
更新アイコンをクリックして、NetScaler ADMで最近検出されたNetScalerインスタンスを、このウィンドウで利用可能なインスタンスのリストに追加することもできます。
NetScaler ADM APIを使用して構成パックを作成する
選択したNetScalerインスタンスにファイルをアップロードする構成パックを作成するために、NetScaler ADM APIを使用することもできます。APIの使用方法の詳細については、「任意のファイルタイプをアップロードする構成を作成するためのAPIの使用方法」を参照してください。