Application Delivery Management

StyleBook 类别

NetScaler® Application Delivery Management (ADM) 中有两种 StyleBook 类别:默认 StyleBook 和自定义 StyleBook。无论是默认 StyleBook 还是自定义 StyleBook,都可分为公共 StyleBook 或私有 StyleBook。在 NetScaler ADM 中,您可以查看系统中存在的所有 StyleBook,无论其类型或可见性状态如何。您还可以查看 StyleBook 之间如何相互连接的图形显示。

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

  • 下载自定义 StyleBook 并进行修改,或基于现有 StyleBook 创建 StyleBook。
  • 隐藏 ADM 默认 StyleBook。
  • 从 NetScaler ADM 中删除自定义 StyleBook。
  • 为 StyleBook 添加标签。

默认 StyleBook 和自定义 StyleBook

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

默认 StyleBook 和自定义 StyleBook 都可以是公共的或私有的。

公共 StyleBook 和私有 StyleBook

可用于创建配置包的 StyleBook 可归类为公共 StyleBook。也就是说,它们都可供您直接使用,以通过 NetScaler ADM GUI 和 API 创建配置。

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

标记为私有的 StyleBook 示例

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
<!--NeedCopy-->

查看 StyleBook

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

在 NetScaler ADM 中,导航到 Applications(应用程序)> StyleBooks,您可以查看系统中存在的 StyleBook 列表。

默认公共 StyleBook 的面板上具有以下图标:

默认公共 StyleBook

而默认私有 StyleBook 具有一个声明其为私有 StyleBook 的图标:

私有图标

虽然您可以查看私有 StyleBook 的定义和依赖项,但无法使用 GUI 从私有 StyleBook 创建配置包。私有 StyleBook 的主要目的是将其用作另一个 StyleBook 的构建块。使用构建块 StyleBook 鼓励重用常见的配置模式。

自定义公共 StyleBook 具有不同的图标,如下图所示:

默认公共图标

而自定义私有 StyleBook 则显示此图标:

默认私有图标

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

按公共和私有筛选 StyleBook

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

搜索 StyleBook

下载自定义 StyleBook

要从 NetScaler ADM 下载自定义 StyleBook,请导航到 Applications(应用程序)> StyleBooks > Configurations(配置)。在右侧面板上显示的 StyleBook 列表中,选中下载自定义 StyleBook 的选项。单击 Download(下载)。如果 StyleBook 具有依赖的自定义 StyleBook,则可以将依赖的 StyleBook 包含在下载的捆绑包中。

注意:

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

下载 StyleBook

注意:

您无法下载 NetScaler ADM 默认 StyleBook。您可以查看它们的定义和依赖项。为此,请单击 StyleBook 面板上的 View Definition(查看定义)和 View Dependencies(查看依赖项)链接。

删除自定义 StyleBook

您还可以通过单击 Delete(删除)按钮来删除自定义 StyleBook。此时会弹出一个窗口,提示您确认是否要从 NetScaler ADM 中删除 StyleBook。如果 StyleBook 使用其他自定义 StyleBook,则可以通过选中复选框来选择删除此类 StyleBook。

删除 StyleBook

注意:

如果自定义 StyleBook 在 NetScaler ADM 中具有依赖 StyleBook,请勿删除它。否则,它将破坏现有的 StyleBook。

查看 StyleBook 依赖项

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

NetScaler ADM 允许您查看 StyleBook 之间如何相互连接的图形显示。此表示对于使用其他 StyleBook 作为构建块构建的复杂 StyleBook 尤其有用。通过查看依赖关系图,可以了解多个 StyleBook 之间的关系和依赖项。

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

查看 StyleBook 依赖项

在 NetScaler ADM 中,导航到 Applications(应用程序)> StyleBooks。StyleBooks 页面显示 NetScaler ADM 中可供您使用的所有 StyleBook。向下滚动并找到您的 StyleBook。StyleBook 磁贴显示用于创建配置、查看 StyleBook 定义和查看 StyleBook 依赖项的链接。单击 View Dependencies(查看依赖项)。

正向依赖项

Forward Dependencies(正向依赖项)选项卡允许您查看 StyleBook 正在使用的不同默认 StyleBook。按照箭头查找 StyleBook 正在使用的 StyleBook。当您将鼠标指向其中一个箭头时,该箭头以及相互连接的 StyleBook 将突出显示。您还可以单击 StyleBook 名称以查看该 StyleBook 的定义。

正向依赖项

反向依赖项

Reverse Dependencies(反向依赖项)选项卡允许您以图形方式查看正在使用您的 StyleBook 的 StyleBook。如果您按照箭头操作,您会看到显示中的所有 StyleBook 都指向您的 StyleBook。有些 StyleBook 可能直接使用该 StyleBook,有些 StyleBook 可能通过另一个 StyleBook 使用该 StyleBook。

反向依赖项

针对配置包审核 ADC 配置

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

  • 检测 StyleBook 配置包与 ADC 配置之间的配置漂移。

  • 识别 ADC 上任何已修改和已删除的对象,这些对象未反映配置包所做的更改。

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

  1. 导航到 Applications(应用程序)> StyleBooks > Configurations(配置)。

  2. 单击 Configuration Audit(配置审核)。

    “Configuration Audit”(配置审核)页面显示已创建和已审核的对象。

    针对配置包审核 ADC 配置

为 StyleBook 创建标签

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

要为 StyleBook 添加标签:

  1. 导航到 Applications(应用程序)> StyleBooks

  2. 在要添加标签的 StyleBook 上选择 Tags(标签)。

    StyleBook 的标签

    您可以为所有类型的 StyleBook 添加标签。

  3. 指定所需的 Key(键)和 Value(值)信息,以帮助您筛选 StyleBook。

    例如,Key=team 和 Value=bizdata

    为 StyleBook 创建标签

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

  4. 单击 Create(创建)。

要使用标签筛选 StyleBook,请在搜索栏中单击 Tags(标签),然后从列表中选择键和值。将显示与指定标签匹配的 StyleBook。

如何使用标签

以下是搜索具有 key=teamvalue=bizdata 标签的 StyleBook 的示例:

标签示例

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

创建配置包时,请在 Tag Association(标签关联)部分中使用以下选项之一:

  • Associate all present and future StyleBook tags with the configuration(将所有当前和未来的 StyleBook 标签与配置关联)– 此选项将所有 StyleBook 标签与配置包关联。它还确保关联您将来可能添加到 StyleBook 的新标签。

  • Select tags(选择标签)– 此选项显示所选 StyleBook 的标签。您可以选择所需的 StyleBook 标签并与配置包关联。

将 StyleBook 标签与其配置包关联

使用 CLI 命令配置 StyleBook

如果要使用 CLI 命令配置任何 StyleBook,请执行以下操作:

两次输出之间的差异显示了您可以使用 NetScaler CLI 配置任何 StyleBook 的 CLI 命令。