在 NetScaler 控制台中,您可以从样书创建配置包。 并且,配置包与创建它的样书相关联。 配置包的更新是通过与其绑定的样书进行的。
执行以下操作从样书创建配置包:
导航到 应用程序 > StyleBooks > 配置。
单击 添加。
在 选择样书中,选择要从中创建配置包的所需样书。
此页面将样本分为默认样本和自定义样本。 选择相应的选项卡来查找所需的样本。
指定所需的详细信息,例如应用程序名称、IP 地址、端口或协议类型。
各个样书的 GUI 字段有所不同。
在 目标实例中,选择要运行配置的实例或实例组。
笔记:
可以根据需要指定多个目标实例,在多个 NetScaler 上部署配置。
点击 Dry Run。
对象 页面显示从 NetScaler 实例创建、修改或删除的对象。
点击 创建
配置包出现在 StyleBook > Configurations 页面中。
如果要编辑现有的配置包,请选择该配置包并单击 编辑。
有时,您可能在 Stylebook 之外创建了 NetScaler 配置,无论是由于特定的操作需求还是遗留设置。 您现在可以将这些先前存在的配置作为 Stylebook 配置包的一部分进行集成和管理,从而实现更灵活和集中的管理。
例如,在此功能之前,如果 NetScaler 已经配置了 SSL 配置文件,并且如果 StyleBook 的配置包操作尝试创建具有相同名称的 SSL 配置文件,则配置包操作将失败并出现“资源已存在”错误。 现在启用此功能后,configpack 操作成功,并且可以在新的配置包中重复使用具有相同名称的现有 SSL 配置文件。
同样,您可能还会面临跨多个应用程序或配置需要网络设置、安全策略或部分应用程序配置等资源的情况。 此功能使您能够跨多个配置包共享配置。
要启用此功能,请按照以下步骤操作:
导航到应用程序 > 配置 > 样式手册。
在 Stylebooks 页面上,选择您将用于创建新配置包的 Stylebook 或与您正在编辑的配置包相关联的 Stylebook。
在“选择操作”中,单击“配置设置”。
有时,您需要更新样书以添加功能或修复问题。 如果您已经使用旧样书创建了配置包,您可能需要更新它们以使用新更新的样书。 要使用新的样本,请更改配置包的现有样本。
考虑一个示例 StyleBook example-lb ,它在 NetScaler 实例上部署了一个基本的负载均衡器配置。 并且,您可以从此样本中创建配置包 CP1。
当您想要使用基本负载平衡器配置来配置监视器时,您需要一个新的样书。 因此,创建 example-lb-mon StyleBook,其中包括配置监视器以及基本负载均衡器配置的能力。
创建样书后,更新现有的配置包 CP1 以添加一些监视器。 为此,请执行以下操作:
导航到 应用程序 > StyleBooks > 配置。
选择您想要更改样本的配置包。
在此示例中,从列表中选择 CP1。
单击 更改样式簿。
从列表中选择所需的样本。 然后,点击 保存选择。
单击 更改。
在此示例中,从列表中选择 example-lb-mon 。
当您更改配置包的样本时,新样本中的参数可能与现有样本具有不同的结构。 如果参数结构与之前的样书类似,则参数的值会自动保留在各自的字段中。 否则,仅传输两个样书之间具有相同结构的参数。 例如相同的参数名称、类型、参数父级等等。
如果在新的样本中添加了新的必需参数,则在更改样本后,必须手动指定这些参数的值。
在此示例中, example-lb StyleBook 的配置页面上显示的参数如下:
新 example-lb-mon StyleBook 的配置页面上显示的参数如下:
在这种情况下,样书会保留基本负载均衡器配置的旧值,因为新的样书尚未更改现有参数。 并且,它只添加了新的参数。 对于监视参数,手动指定所需的值。
在 目标实例中,查看所选实例并在必要时更新列表。
点击 Dry Run。
对象 页面显示从 NetScaler 实例创建、修改或删除的对象。
单击 确定。
在 StyleBook > Configurations 页面中, StyleBook Name 列显示所选配置包的新 StyleBook 名称。 在这种情况下,它显示 example-lb-mon。
更改具有多个配置包的现有样本时,请执行以下操作:
将新的样本导入 NetScaler 控制台。
通常,新的样书具有相同的名称和命名空间,但版本高于现有的样书。 但是,如果名称、命名空间或版本不同,则可以跳过此步骤。
更改与现有样本关联的配置包的样本。
仅当选定的配置包与同一样本相关联时,您才可以选择 更改样本 。
对于选定的配置包,当满足以下条件时,NetScaler 控制台将成功更改样本:
现有样本的所有配置参数必须出现在所选样本中。
所选样本中的新参数是可选的。
要查看所选配置包的进度,请在 配置 页面中选择 正在进行/失败的配置 。
将所有配置包绑定到新样书后,从 NetScaler 控制台中删除旧样书。
您可以导出或导入像 StyleBooks 这样的配置包。 利用此功能,您可以轻松地将 StyleBook 配置共享到另一个 NetScaler 控制台。 当您导出配置包时, tgz
或 zip
包将下载到您的本地计算机。 该捆绑包包含一个 JSON 文件,其中所有参数均在配置包中定义。
执行以下操作来导出配置包:
导航到 应用程序 > StyleBooks > 配置。
选择您想要导出的配置包。
在 选择操作中,选择 导出配置。
在 导出配置 窗格中,指定以下内容:
部署配置的目标实例信息:选择此选项可将目标实例的信息包含在导出包中。
与配置相关的样书:选择此选项可将样书包含在导出包中。
用于保护导出配置数据的密码:指定用于加密导出包的密码。 此密码可保护配置包的敏感数据。
压缩文件类型:选择 ZIP 或 TGZ 文件类型。
单击 导出。
将导出包保存在本地计算机上。
您可以将配置包从本地计算机导入到不同的 NetScaler 控制台。 要导入配置包,请执行以下操作:
导航到 应用程序 > StyleBooks > 配置。
选择 导入配置。
从您的计算机中选择导入文件包。
使用您在导出期间指定的密码。
可选,在高级选项中,选择 仅当所有配置对象已存在于 NetScaler上时才允许创建新配置。
此选项不会改变已在 NetScaler 实例上创建的对象。
假设您在两个 NetScaler 控制台服务器中添加了相同的 NetScaler 实例。 并且,您想要将配置包从一台 NetScaler 控制台服务器迁移到另一台服务器。 使用此选项可以导入配置包,而无需更改 NetScaler 实例上的配置对象。
重要的
要使用此选项,请确保指定的配置包具有目标实例信息。 参见, 导出配置。
仅当所有对象都存在于目标实例上时,此选项才会迁移配置。
导入配置包时,NetScaler 控制台会验证以下内容:
关联样书:如果关联样书不在 NetScaler 控制台中,它会将样书与配置包一起导入。
目标实例:检查目标实例并在指定的目标实例上部署配置。 如果 NetScaler 控制台中不存在上述 NetScaler 实例,则导入的配置包将不包含目标实例。
源 NetScaler 控制台:如果您在同一 NetScaler 控制台服务器上导入配置包,则所选捆绑包将更新现有的配置包。
配置包中的 保存为草稿 选项允许您将配置更改保存为草稿。 此功能会保存更改,而不会立即将其部署到 NetScaler 实例。
要将配置包保存为草稿:
一旦配置包保存为草稿,您的配置更改就不会直接部署到 NetScaler 实例。 相反,配置包作为草稿存储在 草稿配置 选项卡下的 待定配置中。
在 Draft Configurations 选项卡中,选择配置包执行以下操作:
您还可以安排何时部署已保存的草稿。
有关更多信息,请参阅 安排配置包。
创建配置包时,默认情况下配置包会自动部署到 NetScaler 实例。 使用此功能,您可以安排何时部署配置包。
要为配置包创建时间表:
所有计划配置都存储在 计划配置 选项卡下的 待定配置中。 您可以选择已创建的计划,对计划进行编辑、部署或取消操作。
您还可以创建计划来编辑和删除已部署的配置包。
要创建计划来编辑已部署的配置包:
要创建删除已部署的配置包的计划:
要从配置包中分离目标实例,请执行以下操作:
导航到 应用程序 > 配置 > 配置包。
选择要删除的目标实例的配置包。
在 选择操作中,选择 分离目标。
在 分离目标 窗格中,选择要从配置包中删除的目标实例。
单击 确定。
显示一条消息,确认创建重复配置包,并且目标实例现已删除。
example-lb StyleBook 的完整内容供您参考如下:
名称:example-lb
命名空间:examples.stylebooks
版本:“1.0”
显示名称:基本负载均衡器应用程序
描述:这是一个创建负载均衡器应用程序的示例样书
模式版本:“1.0”
导入样式书:
-
命名空间:com.citrix.adc.stylebooks
前缀:stlb
版本:“1.0”
参数默认源:
- stlb::lb
组件:
-
名称: lb-comp
类型:stlb::lb
描述:使用默认的 lb StyleBook 构建典型的 lb 配置对象
properties-default-sources:
- $parameters
<!--NeedCopy-->
example-lb-mon StyleBook 的完整内容供您参考如下:
名称:example-lb-mon
命名空间:examples.stylebooks
版本:“1.0”
描述:这是一个示例 StyleBook,它创建了一个带有监视器的负载均衡器应用程序
显示名称:带有监视器的基本负载均衡器应用程序
模式版本:“1.0”
导入样式书:
-
命名空间:netscaler.nitro.config
前缀:ns
版本:“10.5”
-
命名空间:com.citrix.adc.stylebooks
前缀:stlb
版本: “1.0”
-
命名空间:com.citrix.adc.commontypes
前缀:cmtypes
版本:“1.0”
参数默认源:
- stlb::lb
参数:
-
名称:监视器
标签:“监视器列表”
描述:“用于监视应用程序服务器的监视器列表”
类型:cmtypes::monitor[]
替换:
mon-name(appname, monname): $appname + "-mon-" + $monname
组件:
-
名称:lb-comp
类型:stlb::lb
描述:使用默认 lb StyleBook 构建典型的 lb 配置对象
properties-default-sources:
- $parameters
-
名称:monitors-comp
类型:cmtypes::monitor
条件: $parameters.monitors
重复: $parameters.monitors
repeat-item: mon
repeat-index: ndx
description: 构建 NetScaler 监视器对象列表并将它们绑定到此 LB 配置的服务组
properties-default-sources:
- $mon
properties:
MonitorName: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
components:
-
name: Monitor-svcg-binding-comp
条件: $parameters.svc-servers
类型:ns::servicegroup_lbmonitor_binding
属性:
servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
Monitor_name: $parent.properties.monitorname
<!--NeedCopy-->