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