StyleBook 类别
在 NetScaler Console 中，StyleBook 分为两类：默认和自定义，它们可以是公共的或私有的。NetScaler Console 允许您查看系统中存在的所有 StyleBook 以及它们之间的连接方式。
本文档介绍了不同类型的 StyleBook 以及您可以从 NetScaler Console 对 StyleBook 执行的以下操作：
-
下载自定义 StyleBook 并进行修改，或基于现有 StyleBook 创建新的 StyleBook。
-
隐藏 NetScaler Console 默认 StyleBook。
-
从 NetScaler Console 中删除自定义 StyleBook。
-
向 StyleBook 添加标签。
默认和自定义 StyleBook
-
默认 StyleBook 是随 NetScaler Console 提供的 StyleBook，它们允许您创建可在 NetScaler 实例上部署的配置。您无法删除默认 StyleBook，但可以从 NetScaler Console GUI 中将其隐藏。
-
自定义 StyleBook 是您导入到 NetScaler Console 中的 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
查看 StyleBook
NetScaler Console 中默认和私有 StyleBook 的数量正在增加。您可能希望搜索要访问的特定 StyleBook。您可能还希望单独查看这两种类型的 StyleBook。
在 NetScaler Console 中，当您导航到 Applications > Configuration > StyleBooks 时，您可以查看系统中存在的 StyleBook 列表。
默认公共 StyleBook 的面板上具有以下图标：
而默认私有 StyleBook 具有一个图标，表明它是私有 StyleBook：
虽然您可以查看私有 StyleBook 的定义和依赖项，但您无法使用 GUI 从私有 StyleBook 创建配置包。私有 StyleBook 的主要目的是将其用作另一个 StyleBook 的构建块。使用构建块 StyleBook 鼓励重用常见的配置模式。
自定义公共 StyleBook 具有不同的图标，如下图所示：
而自定义私有 StyleBook 显示此图标：
在页面右上角，您可以看到一个选项，用于选择要查看的 StyleBook 类型。有三个选项 - 所有、公共或私有 StyleBook。单击其中一个选项。
您还可以通过单击搜索图标来搜索特定的 StyleBook。您可以按名称、命名空间和版本属性或这些选项的组合进行搜索。搜索操作不区分大小写。
搜索 StyleBook(/en-us/netscaler-console-service/media/nmas-stylebooks-searching-icon-new.png)
下载自定义 StyleBook
要从 NetScaler Console 下载自定义 StyleBook，请导航到 Applications > Configuration > Confg Packs。在右侧面板上显示的 StyleBook 列表中，选中下载自定义 StyleBook 的选项。单击 Download。如果 StyleBook 具有依赖的自定义 StyleBook，则可以在下载的捆绑包中包含这些依赖的 StyleBook。
注意
您可以下载标记为公共或私有的自定义 StyleBook。
下载 StyleBook(/en-us/netscaler-console-service/media/mas-download-custom-stylebooks-new.png)
注意
您无法下载 NetScaler Console 默认 StyleBook。您可以查看它们的定义和依赖项。为此，请单击 StyleBook 面板上的 View Definition 和 View Dependencies 链接。
更新自定义 StyleBook
您可以直接从 NetScaler Console GUI 更新自定义 StyleBook 定义。因此，您可以在不更改其版本的情况下更改 StyleBook。您还可以更新从 StyleBook 捆绑包导入的定义。
重要
在从 NetScaler Console GUI 更新 StyleBook 定义之前，请确保 StyleBook 定义没有依赖的 StyleBook。
您可以更新具有配置包的 StyleBook 定义。确保 StyleBook 定义向后兼容。因此，所有参数都保留在更新的 StyleBook 中，并且新添加的参数显示为可选。
-
导航到 应用程序 > 配置 > 样式簿。
-
选择 Custom StyleBooks 选项卡。
-
在您要更新的 StyleBook 上选择 更新定义。
-
根据需要更新定义，然后单击 更新。更新自定义 StyleBook(/en-us/netscaler-console-service/media/update-stylebook-definition-inline.gif)
-
刷新页面以查看最新更改。
删除自定义 StyleBook
您也可以通过单击 删除 按钮来删除自定义 StyleBook。一个弹出窗口会提示您确认是否要从 NetScaler Console 中删除该 StyleBook。如果该 StyleBook 使用了其他自定义 StyleBook，您可以勾选复选框来选择删除这些 StyleBook。
删除 StyleBook(/en-us/netscaler-console-service/media/mas-delete-custom-stylebooks-new.png)
注意：
如果自定义 StyleBook 在 NetScaler Console 中有依赖的 StyleBook，请勿删除它。此操作可能会破坏现有的 StyleBook。
查看 StyleBook 依赖项
StyleBook 的一个重要而强大的功能是它们可以作为其他 StyleBook 的构建块。
您可以：
-
将一个 StyleBook 导入另一个 StyleBook - 导入的 StyleBook 被声明为一种类型，并由第二个 StyleBook 的组件或参数使用。查看 NetScaler Console 中现有的默认 StyleBook，了解如何在一个 StyleBook 的基础上构建另一个 StyleBook。
-
查看 StyleBook 之间如何连接的图形显示 - 这种表示对于使用其他 StyleBook 作为构建块构建的复杂 StyleBook 非常有用。依赖关系图允许您查看 StyleBook 之间的关系和依赖项。
注意：
您不能删除被其他 StyleBook 使用的 StyleBook，因为此操作可能会破坏现有 StyleBook。使用依赖关系图显示来识别哪些 StyleBook 阻止了 StyleBook 的删除。
查看 StyleBook 依赖关系
在 NetScaler Console 中，导航到 Applications > Configuration > StyleBooks。StyleBooks 页面显示了 NetScaler Console 中所有可供您使用的 StyleBook。向下滚动并找到您的 StyleBook。单击 View Dependencies 以查看依赖的 StyleBook。
正向依赖关系
Forward Dependencies 选项卡允许您查看您的 StyleBook 正在使用的不同默认 StyleBook。沿着箭头查找 StyleBook 正在使用的 StyleBook。当您将鼠标指向其中一个箭头时，该箭头以及相互连接的 StyleBook 将被突出显示。您还可以单击 StyleBook 以查看该 StyleBook 的定义。
反向依赖关系
Reverse Dependencies 选项卡允许您以图形方式查看正在使用您的 StyleBook 的 StyleBook。如果您沿着箭头，您可以看到显示中的所有 StyleBook 都指向您的 StyleBook。某些 StyleBook 可能直接使用该 StyleBook，而某些 StyleBook 可能通过另一个 StyleBook 使用该 StyleBook。
根据配置包审计 NetScaler 配置
您可以将 StyleBook 配置包所做的更改与当前的 NetScaler 配置进行比较。通过此比较，您可以执行以下操作：
-
检测 StyleBook 配置包与 NetScaler 配置之间的配置漂移。
-
识别 NetScaler 上未显示配置包所做更改的任何已修改和已删除对象。
要将配置包更改与 NetScaler 实例配置进行比较，请执行以下操作：
-
导航到 应用程序 > 配置 > 配置包。
-
点击 配置审计。配置审计页面显示已创建和已审计的对象。
注意：
在更新部署在 NetScaler 实例上的 StyleBook 配置包时，它可能与其部署状态存在差异。并且，它会使配置包更新失败。StyleBook 引擎会自动协调这些差异并更新配置包。
下载配置包的支持包
配置包的支持包有助于 Citrix 技术支持团队查看、分析和排查配置包问题。要下载支持包，请执行以下步骤：
-
转到 应用程序 > 配置 > 配置包。
-
选择要下载支持包的配置包。
-
在 选择操作 中，点击 支持包。您可以将包压缩为 Zip 或 TGZ 文件格式。
-
可选，指定密码以加密包文件。
-
点击 下载。
为 StyleBook 创建标签
您可以在 NetScaler Console 中为任何 StyleBook 添加标签。标签是键值对，可让您使用不同的条件对 StyleBook 进行分组。您可以在 NetScaler Console 中搜索或筛选 StyleBook 时使用这些标签。
要为 StyleBook 添加标签，请执行以下操作：
-
导航到 应用程序 > 配置 > 样式簿。
-
在要添加标签的 StyleBook 上选择 Tags。
您可以为所有类型的 StyleBook 添加标签。 -
指定所需的 Key 和 Value 信息，以帮助您筛选 StyleBook。例如，键=team 和 值=bizdata
要添加更多标签，请单击 +。 -
单击 Create。
要使用标签筛选 StyleBook，请在搜索栏中单击 Tags，然后从列表中选择一个键和值。将显示与指定标签匹配的 StyleBook。
以下是搜索具有标签的 StyleBook 的示例，其中
key=team 和 value=bizdata：
您可以将 StyleBook 标签与其配置包关联。因此，您可以使用 StyleBook 标签本身来搜索配置包。
创建配置包时，请在“标签关联”部分使用以下选项之一：
-
将所有当前和未来的 StyleBook 标签与配置关联 – 此选项将所有 StyleBook 标签与配置包关联。它还确保关联您将来可能添加到 StyleBook 的新标签。
-
选择标签 – 此选项显示所选 StyleBook 的标签。您可以选择所需的 StyleBook 标签并将其与配置包关联。
克隆 StyleBook
作为管理员，您可以创建 StyleBook 及其依赖 StyleBook 的副本。然后，您可以使用此捆绑包进行自定义，例如更新
parameters 和 components 部分。
要克隆 StyleBook：
-
导航到 应用程序 > 配置 > 样式簿。
-
在要复制的默认或自定义 StyleBook 上选择“克隆”。
-
在“克隆 StyleBook”页面中，为 StyleBook 和依赖 StyleBook 输入命名空间和版本。您还可以选择建议的命名空间和版本。
注意：克隆的 StyleBook 及其依赖 StyleBook 必须具有不同的命名空间和版本，以将其与现有 StyleBook 区分开来。您不能将任何保留的 NetScaler Console 命名空间用于克隆的 StyleBook。 -
点击 克隆。克隆的 StyleBook 包已导入到 NetScaler Console 并显示在 StyleBooks 页面中。