NetScaler ConsoleにファイルをアップロードするためのStyleBookを作成する
NetScaler Application Delivery Management (NetScaler Console) の StyleBooks を使用すると、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コンポーネントで使用します。以下は、geo-locationファイルをアップロードするための代替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 instanceにgeolocationファイルをアップロードする構成を作成します。
ファイルをアップロードするための構成を作成するには:
-
In NetScaler Console, navigate to Applications > Configuration, and click Create New. The Choose StyleBook page displays all the StyleBooks that are available in your NetScaler Console. Scroll down and select the StyleBook that you imported.StyleBook パラメーターは、この StyleBook で定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして表示されます。
-
基本ロードバランサー設定セクションで、ロードバランサーの名前と仮想 IP アドレスを入力します。
-
Location Fileセクションで、ファイルの名前または場所を入力します。注NetScaler Consoleで、ファイルが現在のテナントのフォルダーの下にのみ配置されていることを確認してください。任意のファイル転送プロトコルを使用して、ファイルをNetScaler Consoleファイルシステムにコピーします。
-
ターゲットインスタンスにアクセスする前に、ユーザー資格情報の提供を求められる場合があります。
-
構成を作成する必要があるターゲットのNetScalerインスタンスを選択し、作成をクリックします。
注
インスタンスで実際の構成を実行する前に、ターゲットインスタンスで作成される構成オブジェクトを確認するために、ドライランを選択することをお勧めします。
構成パックの作成が成功すると、ファイルはNetScalerインスタンスのファイルシステム上の次の場所に保存されます: /var/netscaler/inbuilt_db/
注
更新アイコンをクリックして、NetScaler Consoleで最近検出されたNetScalerインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。
NetScaler Console APIを使用して構成パックを作成する
NetScaler Console APIを使用して、選択したNetScalerインスタンスにファイルをアップロードする構成パックを作成することもできます。APIの使用方法の詳細については、任意のファイルタイプをアップロードするための構成を作成するAPIの使用方法を参照してください。