产品文档
Application Delivery Management
14.1 - Current Release 13.1 13.0
查看 PDF

创建和使用自定义样书

February 6, 2024
投稿者: 
C

您可以为部署编写自己的样书，将其导入到 Citrix Application Delivery Management (ADM)，然后创建配置对象。还可以使用 API 根据您的样书创建配置。

本文档包含以下信息：

开始之前的准备工作

开始创建样书之前，请确保您了解以下内容：

样书文件使用 YAML 格式。有关 YAML 格式的信息，请参阅 YAML 语法。

下面是创建样书时必须了解的 YAML 准则列表：

  • YAML 区分大小写。
  • YAML 要求使用正确的行首缩进。
  • 使用 <spacebar> 键创建正确的缩进。不要使用 <tab> 键。在将样书导入 MA Service 时，使用 <tab> 键会导致编译错误。
  • 请勿在字符串两边加引号。仅当字符串包含标点符号（破折号、冒号等）时才在字符串两边加引号。如果要将数字解释为字符串，请在数字两边加引号或使用样书的内置函数 str()。

  • YES/Yes/yes/Y/y/NO/no/No/n/N、ON/On/on/OFF/Off/off 和 TRUE/true/truthy/FALSE/False/false/falsely 等字面值被视为布尔值，分别等同于 true 和 false。要将它们解释为字符串，请在其两边加引号。例如：

    • “YES”
    • “No”
    • “True”
    • “False” 等等。

注意

在将样书文件导入 Citrix ADM 之前，建议您验证您的文件是否符合 YAML 格式。Citrix 建议您使用样书中的内置 YAML 验证程序来验证和导入 YAML 内容。

配置样本时，您只能使用支持创建和删除操作的 Nitro 配置资源（POST 和 DELETE HTTP 方法）。有关更多信息，请参阅 Nitro API 文档。

样书解析

编写样本要求您了解样本的语法、句法和结构。典型的样书包含以下部分：

  • 标题：本节允许您定义样书的标识并描述其用途。这是必需的部分。
  • 导入样书：此部分用于声明要在当前样书中引用哪个其他样书。编写样书需要导入 Citrix ADC NITRO 配置样书或其他样书。这是必需的部分。
  • 参数：此部分用于定义样书中所需的参数以创建配置。它描述样书接收的输入。这是可选部分。

  • 组件：此部分允许您定义样书为特定配置创建的实体（配置对象）。此部分被视为样本的核心。组件通常使用 parameters 部分中提供的输入来改写样本生成的配置。这是可选部分。

    样书可以包含参数部分或组件部分，也可以同时包含两者。如果要定义其他样本可以使用的一组参数，可以使用仅含 parameters 部分的样本。这有利于在一组样本之间重用参数组。如果要在样本中指定属性值，而不是定义参数来接收用户输入，可以使用仅含 components 部分的样本。

  • 输出：参数部分定义样书的输入时，此可选部分定义其输出。在此可选输出部分，可以指定要向基于此样本创建配置的用户和导入此样本的其他样本呈现的组件。之后，用户和导入样书可以引用呈现的组件的属性。
  • 操作：样书可能包含一个可选部分，用于在作为样书一部分的任何虚拟服务器上在 Citrix ADM 中启用分析。

下图显示了一个简单的样书概况。

本地化后的图片

以下示例帮助您了解样书的语法和结构，以及如何编写复杂程度不断增加的样书。

创建和使用自定义样书
February 6, 2024
投稿者: 
C
February 6, 2024
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.