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