Citrix Application Delivery Management 服务

样本组

Citrix Application Delivery Management (ADM) 中有两个样本组。它们是默认样本和自定义样本。无论是默认样本还是自定义样本,样本都是公共样本或私有样本。在 Citrix ADM 中,您可以查看系统中存在的所有样本,无论其类型或可见性状态如何。您还可以查看样本之间如何连接的图形显示。

本文档介绍了不同类型的样本。此外,它还介绍了您可以对 Citrix ADM 的样本执行的以下操作:

  • 下载自定义样本并进行修改,或根据现有样本创建样本。
  • 隐藏 ADM 默认样本。
  • 从 Citrix ADM 中删除自定义样本。
  • 将标签添加到样书中。

默认和自定义样本

  • 默认样本 是 Citrix ADM 随附的样本,它们允许您创建可在 Citrix ADC 实例上部署的配置。您无法删除默认样本,但可以从 ADM GUI 中隐藏它们。
  • 定义样本 是您自己导入到 Citrix ADM 的样本。

默认样本和自定义样本都可以是公有样本,也可以是私有样本。

公共和私人样本

您可以从中创建配置包的样书可以归类为 公共 样书。也就是说,它们都可以直接用于从 Citrix ADM GUI 和 API 创建配置。

但是,某些样本用作其他样本的构建块。此类样本被标记为 有。私有样书不能直接用于从 Citrix ADM GUI 创建配置包。但是,您仍然可以在 Citrix ADM 上显示和查看这些样本。要将任何自定义样本标记为 有,请将样本中的私有属性设置为 true。您仍然可以使用私有样书使用 Citrix ADM API 创建配置包。

标记为私有样本的示例

name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
    This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true

查看样本

Citrix ADM 中的样本数量-默认和私有样本数量都在增加。您可能需要搜索要访问的特定样本。您可能还需要单独查看这两种类型的样本。

在 Citrix ADM 中,导航到 应用程序 > 样本 时,可以查看系统中存在的样本列表。

默认公用样本面板上有以下图标:

默认公共样书

默认私有样本有一个将其声明为私有样本的图标:

私人图标

虽然您可以查看私有样书的定义和依赖关系,但不能使用 GUI 从私有样书创建配置包。私有样本的主要目的是将其用作另一个样本的构建块。使用构建块样本鼓励重复使用常见的配置模式。

自定义公用样本具有不同的图标,如下图所示:

默认公共图标

虽然自定义私有样本显示以下图标:

默认私人图标

在页面右上角,您可以看到选择要查看的样本类型的选项。有三个选项-全部样本、公共样本或私有样本。单击其中一个选项。

按公共和私人筛选样书

您也可以通过单击搜索图标来搜索特定样本。您可以按名称、命名空间和版本属性或这些选项的组合进行搜索。搜索操作不区分大小写。

搜索样书

下载自定义样本

要从 Citrix ADM 下载自定义样书,请导航到 应用程序 > 样书 > 配置。在右侧面板上显示的样本列表中,选中下载自定义样本的选项。单击下载。如果样书具有相关的自定义样书,则可以在下载的捆绑包中包含相关样书。

注意

您可以下载标记为公共或私有的自定义样本。

下载样书

注意

您无法下载 Citrix ADM 默认样本。您可以查看它们的定义和依赖关系。为此,请单击样书面板上的 看定义和查看依赖关系 链接。

更新自定义样书

您可以从 ADM GUI 本身更新自定义样书定义。

  1. 导航到 应用程序 > 样书

  2. 选择 自定义样书 选项卡。

  3. 在要 更新的样书上选择更新定义

  4. 根据需要更新定义,然后单击 更新

    更新自定义样书

  5. 刷新页面以查看最新更改。

删除自定义样本

您也可以通过单击 “删除” 按钮 删除 自定义样本。弹出窗口会提示您确认是否要从 Citrix ADM 中删除样本。如果样书使用其他自定义样书,则可以通过选中复选框来选择删除此类样书。

删除样书

确认删除样书

注意

如果自定义样书在 Citrix ADM 中具有相关样书,请不要删除该样书。否则,它会破坏现有的样书。

查看样本依赖关系

样本一个重要的强大功能是它们可以用作其他样本的构建块。您可以将样本导入到另一个样本中。导入的样书声明为类型,并由第二个样书的组件或参数使用。您可以研究 Citrix ADM 中的现有默认样本,了解如何在另一个样本之上构建一个样本。

Citrix ADM 允许您查看样本之间如何连接的图形显示。此表示方式对于使用其他样书作为构建块构建的复杂样书尤其有用。通过查看依赖关系图,可以看到多个样本之间的关系和依赖关系。

其他样书使用的样书无法从系统中删除,因为它会破坏现有的样书。使用依存关系图显示,您可以识别哪些样本阻止删除样本。

查看样本依赖关系

在 Citrix ADM 中,导航到 应用程序 > 样本。样本页面显示所有可供您在 Citrix ADM 中使用的样本。向下滚动并找到您的样本。样书 磁贴会显示创建配置、查看样书定义和查看样书依赖关系的链接。单击 查看依赖关系

前向依赖关系

“向 前依赖关系 选项卡允许您查看样本正在使用的不同默认样本。按照箭头查找样本正在使用的样本。当您将鼠标指向其中一个箭头时,箭头和相互连接的样本会突出显示。您还可以单击样本名称以查看该样本的定义。

前向依赖关系

逆向依赖关系

反向依赖关系 选项卡允许您以图形方式查看使用样本的样本。如果按照箭头进行操作,您可以看到显示屏中的所有样书都指向您的样书。有些样本可能直接使用样本,有些样本可能正在通过其他样本使用样本。

反向依赖关系

根据配置包审核 ADC 配置

您可以将样书配置包所做的更改与当前 ADC 配置进行比较。通过此比较,您可以执行以下操作:

  • 检测样书配置包和 ADC 配置之间的配置偏移。

  • 识别 ADC 上没有反映配置包所做更改的任何修改和删除的对象。

要将配置包更改与 ADC 配置进行比较,请执行以下操作。

  1. 导航到 应用程序 > 样本 > 配置

  2. 单击 配置审核

    “配置审计” 页显示创建和审计的对象。

    根据配置包审核 ADC 配置

为样书创建标签

您可以将标签添加到 Citrix ADM 中的任何样书。标签是键值对,允许您使用不同的条件对样书进行分组。您可以在 Citrix ADM 中搜索或筛选样书时使用这些标签。

要向样书添加标签,请执行以下操作:

  1. 导航到 应用程序 > 样本

  2. 在要为其添加 标签 的样书上选择标签。

    样书的标签

    您可以向所有类型的样书添加标签。

  3. 指定有助于筛选样本的所需 信息。

    例如,键 = 团队和值 = Bizdata

    为样书创建标签

    要添加更多标签,请单击 +

  4. 单击创建

要使用标签过滤样书,请在搜索栏中单击 “ 标签 ”,然后从列表中选择键和值。将显示与指定标签匹配的样书。

如何使用标签

以下是搜索带有标签的样书的示例,其中包括 key=teamvalue=bizdata

标签示例

您可以将样书标签与其配置包相关联。因此,您可以使用样书标签本身搜索配置包。

创建配置包时,请使用 “ 标签关联 ” 部分中的以下选项之一:

  • 将所有现在和未来的样书标签与配置 关联 — 此选项将所有样书标签关联到配置包。它还可以确保将来可能添加到样书中的新标签关联起来。

  • 择标签 — 此选项显示所选样书的标签。您可以选择所需的样书标签并与配置包关联。

将样书标签与其配置包关联