样书组
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
:
您可以将样书标签与其配置包相关联。因此,您可以使用样书标签本身搜索配置包。
创建配置包时,请使用“标记关联”部分中的以下选项之一:
将所有现在和未来的样书标签与配置关联 — 此选项将所有样书标签关联到配置包。它还可以确保将来可能添加到样书中的新标签关联起来。
选择标签— 此选项显示所选样书的标签。您可以选择所需的样书标签并与配置包关联。