导入和使用自定义样本

构建样本后,必须将其导入 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. 单击可供您导入样本的三个选项之一。

    1. 文件 -从您的本地存储中选择所需的文件或文件捆绑。

      注意

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

      本地化后的图片

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

      本地化后的图片

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

      注意

      在撰写样本时,请确保您有以下知识:

      • NITRO API
      • YAML

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

      本地化后的图片

    注意

    您还可以从样本 YAML 文件复制和粘贴内容以验证内容。

  3. 单击创建

    Citrix ADM 现在根据样本语法验证样本是否存在所有语法和语义错误。如果存在任何错误,则不会将样本导入到 Citrix ADM 中。如果没有错误,样本已成功导入,并且现在在样本页面上列出。您可以通过在样本的标题部分中定义的显示名称来识别样本。

    本地化后的图片

    注意

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

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

  4. 要从此样本创建配置,请单击 创建 配置 链接。样本将以用户界面页面形式打开,您可以在此为此样本中定义的所有参数输入值。

  5. 指定参数所需的值。在以下示例中,您可以看到 应用程序名称负载平衡器 IP 地址 字段显示为必填字段,并且可以接受用户值。LB 算法 只有两个值可供您选择,默认情况下,选择 ROUNDROBIN。

    本地化后的图片

  6. 目标实例” 下,单击并选择要在其中运行配置的 Citrix ADC 实例的 IP 地址。您还可以通过根据需要指定任意数量的目标实例,在多个 Citrix ADC 上部署配置。

如果要在实际创建配置之前查看将在 Citrix ADC 上创建的 Citrix ADC (Nitro) 配置对象,请单击试运行。如果您的配置有效,则会显示将根据您提供的值创建的配置对象。在此示例中,此示例样本仅创建一个类型 lbvserver 的对象。这个 lbvserver 是在这个基本示例样本中定义的唯一组件。您可以稍后单击 创建,在所选 Citrix ADC 实例上实际创建配置。

创建完成后,新的 ConfigPack 会在 “配置” 页面上列出。

注意

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

本地化后的图片

搜索自定义样本

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

搜索自定义样本

  1. 在 Citrix ADM 中,导航到 应用程序 > 配置 > 样本
  2. 单击右上角的搜索图标。
  3. 在显示的搜索栏中,从第一个列表中选择 类型,然后从下一个选项列表中选择 自定义
  4. Citrix ADM 仅显示用户定义的样本。

本地化后的图片

导入和使用自定义样本