创建样本以将文件上传到 Citrix ADM

Citrix Application Delivery Management (Citrix ADM) 样本允许您通过使用 Citrix ADM GUI 或 API 创建 Citrix ADC 配置,在将任何类型的文件从本地文件系统上传到 Citrix ADC 实例时,这些配置可能包括其他内容。这些文件可以是示例证书文件或地理位置文件。您还可以指定要上传这些文件的目录。

样本配置

以下是描述如何在 Citrix ADC 实例上上传地理位置文件的示例样本。地理文件通常用于 GSLB 配置,用于根据地理位置定义静态邻近性:

构建您的样本-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)

**注

意**此示例中使用的参数是类型文件。您可以在 Citrix ADM 中导入此样本并使用它上传地理定位文件。

此样本要求该文件已经存在于 Citrix ADM 中(例如,您已经使用 scp 等实用程序将其复制到 Citrix ADM)。 如果要通过 Citrix ADM 将文件上传到 Citrix ADC 而不首先将其复制到 Citrix ADM 文件系统,则可以构建一个样本,其中包含两个 “字符串” 参数,一个用于指定要在 Citrix ADC 上使用的文件名,另一个用于指定文件,然后在上传文件组件中使用这两个参数。以下是用于上传地理位置文件的备用样本:

构建您的样本-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)

创建用于上传文件的配置

以下过程在选定的 Citrix ADC 实例上创建配置,该配置将使用上述第一个样本上传地理定位文件。

要创建用于上传文件的配置,请执行以下操作:

  1. 在 Citrix ADM 中,导航到 应用程序 > 配置,然后单击 创建新。“选择样本” 页面显示 Citrix ADM 中可用的所有样本。向下滚动并选择您导入的样本。

    样本参数显示为用户界面页面,允许您输入此样本中定义的所有参数的值。

  2. 在基本负载平衡器设置部分输入负载平衡器的名称和虚拟 IP 地址。

  3. 位置文件 部分,输入文件的名称或位置。

    注意

    确保在 Citrix ADM 中,文件仅位于当前租户的文件夹下。使用任何文件传输协议将文件复制到 Citrix ADM 文件系统。

  4. 在访问目标实例之前,系统可能会要求您提供用户凭据。

  5. 选择需要在其上创建配置的目标 Citrix ADC 实例,然后单击 创建”。

注意

Citrix 建议您选择试运行来检查在目标实例上创建的配置对象,然后再对该实例执行实际配置。

成功创建配置包后,文件将保存在 Citrix ADC 实例文件系统中的位置:/var/netScal/inbuilt_db/

注意

您还可以单击刷新图标,将 Citrix ADM 中最近发现的 Citrix ADC 实例添加到此窗口中的可用实例列表中。

使用 Citrix ADM API 创建配置包

您还可以使用 Citrix ADM API 创建将文件上传到所选 Citrix ADC 实例的配置包。有关如何使用 API 的更多信息,请参阅如何使用 API 创建配置以上载任何文件类型