Citrix Application Delivery Management 服务

创建样本以将文件上传到 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 创建配置以上载任何文件类型

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