NetScaler ADM にファイルをアップロードするStyleBookを作成する

February 6, 2024

寄稿者:

Citrix Application Delivery Management（Citrix ADM）StyleBooksを使用すると、Citrix ADM GUIまたはAPIを使用して、ローカルファイルシステムからCitrix ADCインスタンスにあらゆる種類のファイルをアップロードする際に、とりわけ含めることができるCitrix ADC構成を作成できます。これらのファイルは、証明書ファイルの例でも位置情報ファイルでもかまいません。これらのファイルをアップロードするディレクトリを指定することもできます。

StyleBookの設定

以下は、NetScaler 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)
 

注:

この例で使用されているパラメータはタイプファイルのものです。このStyleBookをNetScaler ADM にインポートして、ジオロケーションファイルをアップロードできます。

このStyleBookでは、ファイルがCitrix ADM にすでに存在している必要があります（たとえば、scpなどのユーティリティを使用してCitrix ADM に既にコピーしているはずです）。 NetScaler ADMファイルシステムにファイルをコピーせずに、NetScaler ADM経由でNetScaler ADCにファイルをアップロードする場合は、2つの「文字列」パラメータを持つStyleBookを構築できます。1つはNetScaler ADCで使用するファイル名を指定し、もう1つはNetScaler 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)
 

ファイルをアップロードするための構成の作成

以下の手順では、選択したNetScaler ADCインスタンスに、上記の最初のStyleBookを使用して位置情報ファイルをアップロードする構成を作成します。

ファイルをアップロードするための設定を作成するには：

NetScaler ADM で、［ アプリケーション ］>［構成］に移動し、［ 新規作成］をクリックします。「StyleBookの選択」ページには、NetScaler ADM で使用できるすべてのStyleBookが表示されます。下方向にスクロールして、インポートしたStyleBookを選択します。

StyleBookパラメーターは、このStyleBookで定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして表示されます。
ロードバランサーの基本設定セクションにロードバランサーの名前と仮想 IP アドレスを入力します。
[ ロケーションファイル ] セクションで、ファイルの名前または場所を入力します。

注

：Citrix ADM では、ファイルが現在のテナントのフォルダーのみにあることを確認してください。任意のファイル転送プロトコルを使用して、Citrix ADM ファイルシステムにファイルをコピーします。
ターゲットインスタンスにアクセスする前に、ユーザー認証情報を入力するように求められる場合があります。
構成を作成する対象のNetScaler ADC インスタンスを選択し、［作成］をクリックします。

注：

インスタンスで実際の構成を実行する前に、［ Dry Run］を選択して、ターゲットインスタンス上に作成された構成オブジェクトをチェックすることをお勧めします。

構成パックが正常に作成されると、ファイルはNetScaler ADCインスタンスファイルシステムの /var/netscaler/inbuilt_db/ という場所に保存されます。

注

更新アイコンをクリックして、NetScaler ADMで最近検出されたNetScaler ADCインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。

NetScaler ADM APIを使用した構成パックの作成

NetScaler ADM APIを使用して、選択したNetScaler ADCインスタンスにファイルをアップロードする構成パックを作成することもできます。API の使用方法の詳細については、「API を使用して任意のファイルタイプをアップロードする構成を作成する方法」を参照してください。

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

NetScaler ADM にファイルをアップロードするStyleBookを作成する

February 6, 2024

寄稿者:

NetScaler ADM にファイルをアップロードするStyleBookを作成する

StyleBookの設定

StyleBookの作成 -1

StyleBookを構築する-2

ファイルをアップロードするための構成の作成

NetScaler ADM APIを使用した構成パックの作成

この記事の概要