StyleBook 类别
NetScaler Console 中有两种 StyleBook 类别：默认 StyleBook 和自定义 StyleBook。无论是默认 StyleBook 还是自定义 StyleBook，都可分为公有 StyleBook 或私有 StyleBook。在 NetScaler Console 中，您可以查看系统中存在的所有 StyleBook，无论其类型或可见性状态如何。您还可以查看 StyleBook 之间如何相互连接的图形显示。
本文档介绍了不同类型的 StyleBook。此外，它还介绍了您可以从 NetScaler Console 对 StyleBook 执行的以下操作：
- 下载自定义 StyleBook 并进行修改，或基于现有 StyleBook 创建 StyleBook。
- 隐藏默认 StyleBook。
- 从 NetScaler Console 中删除自定义 StyleBook。
- 为 StyleBook 添加标签。
默认 StyleBook 和自定义 StyleBook
-
默认 StyleBook 是 NetScaler Console 随附的 StyleBook，它们允许您创建可部署到 NetScaler 实例上的配置。您无法删除默认 StyleBook，但可以从 NetScaler Console GUI 中将其隐藏。
-
自定义 StyleBook 是您导入到 NetScaler Console 中的 StyleBook。
默认 StyleBook 和自定义 StyleBook 都可以是公有或私有的。
公有 StyleBook 和私有 StyleBook
可以从中创建配置包的 StyleBook 可归类为公有 StyleBook。也就是说，它们都可供您直接使用，以便从 NetScaler Console GUI 和 API 创建配置。
但是，有些 StyleBook 用作其他 StyleBook 的构建块。此类 StyleBook 被标记为私有。私有 StyleBook 无法直接用于从 NetScaler Console GUI 创建配置包。但是，您仍然可以在 NetScaler Console 上显示和查看这些 StyleBook。要将任何自定义 StyleBook 标记为私有，请将 StyleBook 中的 private 属性设置为 true。您仍然可以使用私有 StyleBook 通过 NetScaler Console 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 Console 中默认 StyleBook 和私有 StyleBook 的数量正在增加。您可能需要搜索要访问的特定 StyleBook。您可能还需要单独查看这两种类型的 StyleBook。
在 NetScaler Console 中，当您导航到“应用程序”>“StyleBook”时，可以查看系统中存在的 StyleBook 列表。
默认公有 StyleBook 的面板上具有以下图标：
而默认私有 StyleBook 具有一个声明其为私有 StyleBook 的图标：
虽然您可以查看私有 StyleBook 的定义和依赖项，但无法使用 GUI 从私有 StyleBook 创建配置包。私有 StyleBook 的主要目的是将其用作另一个 StyleBook 的构建块。使用构建块 StyleBook 鼓励重用常见的配置模式。
自定义公有 StyleBook 具有不同的图标，如下图所示：
而自定义私有 StyleBook 则显示此图标：
在页面右上角，您可以看到一个用于选择要查看的 StyleBook 类型的选项。有三个选项：“全部”、“公有”或“私有”StyleBook。单击其中一个选项。
您还可以通过单击搜索图标来搜索特定的 StyleBook。您可以按名称、命名空间和版本属性或这些选项的组合进行搜索。搜索操作不区分大小写。
下载自定义 StyleBook
要从 NetScaler Console 下载自定义 StyleBook，请导航到“应用程序”>“StyleBook”>“配置”。在右侧面板上显示的 StyleBook 列表中，选中下载自定义 StyleBook 的选项。单击“下载”。如果 StyleBook 具有依赖的自定义 StyleBook，则可以将依赖的 StyleBook 包含在下载的捆绑包中。
注意：
您可以下载标记为公有或私有的自定义 StyleBook。
注意：
您无法下载默认 StyleBook。您可以查看它们的定义和依赖项。为此，请单击 StyleBook 面板上的“查看定义”和“查看依赖项”链接。
更新自定义 StyleBook
您可以直接从 NetScaler Console GUI 更新自定义 StyleBook 定义。因此，它有助于您在不更改 StyleBook 版本的情况下对 StyleBook 进行更改。您还可以更新从 StyleBook 捆绑包导入的定义。
重要：
- 在从 NetScaler Console GUI 更新 StyleBook 定义之前，请确保 StyleBook 定义没有依赖的 StyleBook。
- 您可以更新具有配置包的 StyleBook 定义。
- 确保 StyleBook 定义向后兼容。现有 StyleBook 的所有参数都将保留在更新后的 StyleBook 中，并且添加的参数将显示为可选。
-
导航到“应用程序”>“配置”>“StyleBook”。
-
选择“自定义 StyleBook”选项卡。
-
在要更新的 StyleBook 上选择“更新定义”。
-
根据需要更新定义，然后单击“更新”。
-
刷新页面以查看最新更改。
删除自定义 StyleBook
您还可以通过单击“删除”按钮来删除自定义 StyleBook。此时会弹出一个窗口，提示您确认是否要从 NetScaler Console 中删除 StyleBook。如果 StyleBook 使用其他自定义 StyleBook，则可以选择通过选中复选框来删除此类 StyleBook。
注意：
如果自定义 StyleBook 在 NetScaler Console 中具有依赖的 StyleBook，请勿删除它。否则，它将破坏现有 StyleBook。
查看 StyleBook 依赖项
StyleBook 的一个重要而强大的功能是它们可以用作其他 StyleBook 的构建块。您可以将一个 StyleBook 导入到另一个 StyleBook 中。导入的 StyleBook 被声明为一种类型，并由第二个 StyleBook 的组件或参数使用。您可以研究 NetScaler Console 中现有的默认 StyleBook，以了解如何在一个 StyleBook 的基础上构建另一个 StyleBook。
NetScaler Console 允许您查看 StyleBook 之间如何相互连接的图形显示。此表示形式对于使用其他 StyleBook 作为构建块构建的复杂 StyleBook 尤其有用。通过查看依赖关系图，可以查看多个 StyleBook 之间的关系和依赖项。
被其他 StyleBook 使用的 StyleBook 无法从系统中删除，因为它会破坏现有 StyleBook。使用依赖关系图显示，您可以识别哪些 StyleBook 阻止了 StyleBook 的删除。
查看 StyleBook 依赖项
在 NetScaler Console 中，导航到“应用程序”>“StyleBook”。“StyleBook”页面显示 NetScaler Console 中可供您使用的所有 StyleBook。向下滚动并找到您的 StyleBook。StyleBook 磁贴显示用于创建配置、查看 StyleBook 定义和查看 StyleBook 依赖项的链接。单击“查看依赖项”。
正向依赖项
“正向依赖项”选项卡允许您查看您的 StyleBook 正在使用的不同默认 StyleBook。按照箭头查找 StyleBook 正在使用的 StyleBook。当您将鼠标指向其中一个箭头时，该箭头以及相互连接的 StyleBook 将突出显示。您还可以单击 StyleBook 名称以查看该 StyleBook 的定义。
反向依赖项
“反向依赖项”选项卡允许您以图形方式查看正在使用您的 StyleBook 的 StyleBook。如果您按照箭头操作，您会看到显示中的所有 StyleBook 都指向您的 StyleBook。有些 StyleBook 可能直接使用 StyleBook，有些 StyleBook 可能通过另一个 StyleBook 使用 StyleBook。
针对配置包审核 NetScaler 配置
您可以将 StyleBook 配置包所做的更改与当前的 NetScaler 配置进行比较。通过此比较，您可以执行以下操作：
-
检测 StyleBook 配置包与 NetScaler 配置之间的配置漂移。
-
识别 NetScaler 上任何已修改和已删除的对象，这些对象未反映配置包所做的更改。
要将配置包更改与 NetScaler 配置进行比较，请执行以下操作：
-
导航到“应用程序”>“StyleBook”>“配置”。
-
单击“配置审核”。
“配置审核”页面显示已创建和已审核的对象。
下载配置包的支持捆绑包
配置包的支持捆绑包有助于 NetScaler® 技术支持团队查看、分析和排查配置包问题。
-
在“应用程序”>“配置”>“配置包”>“支持捆绑包”中，选择一个配置包。单击“下载”。
-
在“下载支持捆绑包”页面中，指定：
-
使用密码短语加密配置数据 - 如果要指定密码短语来加密捆绑包文件，请选择此选项。
-
密码短语 - 指定一个密码短语来加密导出捆绑包。此密码短语可保护配置包的敏感数据。密码短语必须至少为 20 个字符。
-
压缩文件类型 - 您可以将捆绑包压缩为 ZIP 或 TGZ 文件格式。
-
-
单击“下载”。
为 StyleBook 创建标签
您可以在 NetScaler Console 中为任何 StyleBook 添加标签。标签是键值对，允许您使用不同的条件对 StyleBook 进行分组。您可以在 NetScaler Console 中搜索或筛选 StyleBook 时使用这些标签。
要为 StyleBook 添加标签：
-
导航到“应用程序”>“StyleBook”。
-
在要添加标签的 StyleBook 上选择“标签”。
您可以为所有类型的 StyleBook 添加标签。
-
指定所需的“键”和“值”信息，以帮助您筛选 StyleBook。
例如，Key=team 和 Value=bizdata
要添加更多标签，请单击“+”。
-
单击“创建”。
要在搜索栏中使用标签筛选 StyleBook，请单击“标签”并从列表中选择一个键和值。将显示与指定标签匹配的 StyleBook。
以下是搜索具有 key=team 和 value=bizdata 标签的 StyleBook 的示例：
您可以将 StyleBook 标签与其配置包关联。因此，您可以使用 StyleBook 标签本身搜索配置包。
创建配置包时，请在“标签关联”部分中使用以下选项之一：
-
将所有当前和未来的 StyleBook 标签与配置关联 – 此选项将所有 StyleBook 标签与配置包关联。它还确保将您将来可能添加到 StyleBook 的新标签关联起来。
-
选择标签 – 此选项显示所选 StyleBook 的标签。您可以选择所需的 StyleBook 标签并与配置包关联。
使用 CLI 命令配置 StyleBook
如果要使用 CLI 命令配置任何 StyleBook，请执行以下操作：
- 在 NetScaler 中运行
show ns runningConfig命令。 - 在 NetScaler Console 中，使用默认 StyleBook、业务应用程序 StyleBook 或自定义 StyleBook 创建配置。
- 再次在 NetScaler 中运行
show ns runningConfig命令。
两次输出之间的差异显示了可用于使用 NetScaler CLI 配置任何 StyleBook 的 CLI 命令。
克隆 StyleBook
作为管理员，您可以创建 StyleBook 及其依赖 StyleBook 的副本。然后，您可以使用此捆绑包进行自定义，例如更新 parameters 和 components 部分。
要克隆 StyleBook：
-
导航到“应用程序”>“配置”>“StyleBook”。
-
在要复制的默认或自定义 StyleBook 上选择“克隆”。
-
在“克隆 StyleBook”页面中，为 StyleBook 和依赖 StyleBook 输入命名空间和版本。您还可以选择建议的命名空间和版本。
注意：
克隆的 StyleBook 及其依赖 StyleBook 必须具有不同的命名空间和版本，以将其与现有 StyleBook 区分开来。您不能将任何保留的 NetScaler Console 命名空间用于克隆的 StyleBook。
-
单击“克隆”。克隆的 StyleBook 包将导入到 NetScaler Console 并显示在“StyleBook”页面中。