样书配置

创建用于上载文件的样书

January 29, 2024

投稿者:

NetScaler 控制台样书允许您在使用 NetScaler 控制台 GUI 或 API 将任何类型的文件从本地文件系统上载到 NetScaler 实例时创建 NetScaler 配置，这些配置可能包括其他内容。这些文件可以是示例证书文件或地理定位文件。您也可以指定上载这些文件的目录。

样书配置

以下是样书示例，描述了如何在 NetScaler 实例上上载地理位置文件。地理文件通常用于 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 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)
<!--NeedCopy-->

**注

意**此示例中使用的参数是类型文件。您可以在 NetScaler 控制台中导入这本样书，然后用它来上载地理位置文件。

这本样书要求该文件已经存在于 NetScaler 控制台中（例如，您已经使用像 SCP 这样的实用工具将其复制到 NetScaler 控制台了）。如果您想在不先将文件复制到 NetScaler 控制台文件系统的情况下通过 NetScaler 控制台将其上载到 NetScaler 控制台文件系统，则可以构建具有两个“字符串”参数的样书，一个用于指定在 NetScaler 上使用的文件名，另一个用于指定文件内容，并在上载文件组合组件中使用这两个参数。以下是上载地理位置文件的替代样书：

创建您的样书-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-->

创建用于上载文件的配置

以下过程在选定的 NetScaler 实例上创建配置，该配置将使用上述第一本样书上载地理定位文件。

要创建上载文件的配置，请执行以下操作：

在 NetScaler 控制台中，导航到“**应用程序”“配置”，然后单击“新建**”。“选择样书”页面显示您的 NetScaler 控制台中可用的所有样书。向下滚动并选择您导入的样书。

样书参数显示为用户界面页面，允许您输入此样书中定义的所有参数的值。
在基本负载平衡器设置部分中输入负载平衡器的名称和虚拟 IP 地址。
在“位置文件”部分中，输入文件的名称或位置。

注

意确保在 NetScaler 控制台中，文件仅位于当前租户的文件夹下。使用任何 FTP 将文件复制到 NetScaler 控制台文件系统。
在访问目标实例之前，可能会要求您提供用户凭据。
选择需要在其上创建配置的目标 NetScaler 实例，然后单击创建”。

注意：

Citrix 建议您选择“干运行”以检查在目标实例上创建的配置对象，然后再在实例上运行实际配置。

成功创建配置包后，该文件将保存在 NetScaler 实例文件系统中的位置：/var/netscaler/inbuilt_db/

注意

您也可以单击刷新图标，将最近在 NetScaler 控制台中发现的 NetScaler 实例添加到此窗口的可用实例列表中。

使用 NetScaler 控制台 API 创建配置包

您还可以使用 NetScaler 控制台 API 来创建配置包，将文件上载到选定的 NetScaler 实例。有关如何使用 API 的更多信息，请参阅如何使用 API 创建配置来上载任何文件类型。

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

创建用于上载文件的样书

January 29, 2024

投稿者:

January 29, 2024

投稿者:

这是否有帮助？