Application Delivery Management

使用自定义样本

构建完样书后,必须将其导入 Citrix 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. 原始。在 YAML 编辑器中撰写样书的内容。

      注意

      在撰写样书时,请确保您了解以下内容:

      • NITRO API
      • YAML

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

      本地化后的图片

    注意

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

  3. 单击创建

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

    本地化后的图片

    注意

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

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

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

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

    本地化后的图片

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

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

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

注意

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

本地化后的图片

搜索自定义样本

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

搜索自定义样本

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

    本地化后的图片

使用自定义样本