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