Citrix Application Delivery Management 服务

导入自定义样书

构建样本后,必须将其导入 Citrix Application Delivery Management (ADM) 才能使用它。Citrix ADM 允许您以 YAML 形式导入单个样本或多个样本 YAML 文件作为 .zip、.tgz 或 .gz 形式的捆绑包导入。Citrix ADM 系统在导入时验证您的样本。样书现在可用于创建配置。

Citrix ADM 还具有内置的 YAML 编辑器,您可以使用该编辑器来撰写样本 YAML 内容。YAML 编辑器允许您从 Citrix ADM GUI 本身验证 YAML 结构。您无需为这些验证检查使用单独的工具。内容根据 YAML 标准进行验证,并突出显示任何偏差。然后,您可以更正内容并尝试将样本导入 Citrix ADM。内置的 YAML 编辑器在编写自己的样本时提供了两个优势。

  • 颜色编码。编辑器显示按照 YAML 指南解析的样本内容,颜色编码可帮助您轻松区分 YAML 内容中定义的键和值。
  • YAML 验证。在您输入时,系统会验证内容是否存在任何 YAML 错误,并且任何偏差都会立即突出显示。此验证允许您甚至在 Citrix ADM 中导入样书之前编写符合 YAML 准则的文本。

注意

目前,编辑器根据 YAML 准则验证内容。它不验证代码的正确性和印刷错误。

导入样书

  1. 在 Citrix ADM 中,导航到 应用程序 > 配置 > 样本 ”,然后单击 导入新样本

  2. 单击以下选项之一以导入样书。

    • 文件 -从本地存储中选择所需的文件或文件捆绑包。

      注意

      在此示例中,导入您在中创建的 lb-vserver.yml 样书 用于创建负载平衡虚拟服务器的样本

      导入样书文件

    • 捆绑 -Citrix ADM 允许您以 YAML 格式导入多个样本。您可以导入多个以压缩 (.zip) 格式或压缩 (.tgz, .gz) 格式压缩的 YAML 样书文件。

      导入样书捆绑包

    • Raw -在 YAML 编辑器中撰写样本的内容。

      您可以验证样书内容以检查样书语法错误。要验证样书内容,请单击 验证内容

      注意

      在撰写样书时,请确保了解以下概念:

      • NITRO API
      • YAML

      有关如何编写自己的样本的更多信息,请参阅如何创建您自己的样本

      使用 ADM YAML 编辑器创作样书

    • 同步存储库 -此选项列出添加到 ADM 的存储库。选择要与 ADM 同步的存储库。

      同步 ADM 中的存储库

    注意

    您还可以将样书 YAML 文件中的内容复制并粘贴到 YAML 编辑器。

  3. 可选,选择样书的图标。

    “应用程序” > “样书” 中,导入的样书随此图标显示。

    使用图标导入样书

  4. 单击创建

    Citrix ADM 现在根据样本语法验证样本是否存在所有语法和语义错误。如果存在任何错误,则不会将样本导入到 Citrix ADM 中。

    如果没有错误,则样书将成功导入并在 样书 页面上列出。您可以通过在样本的标题部分中定义的显示名称来识别样本。

    样书示例

    注意

    如果要导入文件包,Citrix ADM 会解压缩压缩文件夹并验证所有样本。 即使一个样本文件未通过验证测试,也不会导入捆绑包。

    有关样本语法和不同构造和属性语法的更多信息,请参阅样本语法

  5. 单击 “ 创建配置 ” 链接,从此样书创建配置。

    样本将以用户界面页面形式打开,您可以在此为此样本中定义的所有参数输入值。

  6. 指定参数所需值。

    在以下示例中,

    1. 指定 应用程序名称负载均衡器 IP 地址 必填字段。

    2. 从列表中选择 负载平衡算法。默认情况下,将选择 “ ROUNDROBIN ”。

    ![配置示例部署](/en-us/citrix-application-delivery-management-service/media/nmas-stylebooks-yaml-editor-4.png)

  7. 在 “ 目标实例” 下,选择要在其中部署配置的 Citrix ADC 实例的 IP 地址。

    您还可以根据需要指定任意数量的目标实例,在多个 Citrix ADC 上部署配置。

  8. 如果要在部署配置之前在 Citrix ADC (NITRO) 配置对象上进行测试,请单击 干运行

    如果配置有效,则会根据指定的值创建配置对象。

    在此示例中,样书只创建一个类型的对象 lbvserver。此负载平衡服务器是此基本示例样书中定义的唯一组件。

    稍后,单击 创建 以在选定的 Citrix ADC 实例上部署配置。

成功部署配置后,“配置” 页中将显示一个新的 置包。

注意

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

新配置包

搜索自定义样本

Citrix ADM 现在允许您根据样本类型搜索样本。也就是说,您现在可以搜索默认样本或自定义样本。当您必须在许多默认样书中搜索用户定义的样书时,此选项尤其有用。

搜索自定义样本

  1. 在 Citrix ADM 中,导航到 应用程序 > 配置 > 样本

  2. 单击右上角的搜索图标。

  3. 在搜索栏中,选择 “ 类型 ”,然后从子列表中选择 “ 自定义 ”。

  4. Citrix ADM 仅显示用户定义的样本。

搜索自定义样本

导入自定义样书