创建和编辑配置包
在 NetScaler Console 中，您可以从 StyleBook 创建配置包。配置包与其创建所用的 StyleBook 绑定。对配置包的更新通过其绑定的 StyleBook 进行。
创建配置包
要从 StyleBook 创建配置包，请执行以下操作：
-
导航到“应用程序”>“StyleBooks”>“配置”。
-
单击“添加”。
-
在“选择 StyleBook”中，选择要从中创建配置包的所需 StyleBook。
此页面将 StyleBook 分为默认 StyleBook 和自定义 StyleBook。选择相应的选项卡以查找所需的 StyleBook。
-
指定所需的详细信息，例如应用程序名称、IP 地址、端口或协议类型。
GUI 字段因 StyleBook 而异。
-
在“目标实例”中，选择要运行配置的实例或实例组。
注意：
通过指定所需数量的目标实例，您可以在多个 NetScaler 上部署配置。
-
单击“试运行”。
“对象”页面显示从 NetScaler 实例创建、修改或删除的对象。
-
单击“创建”。
配置包将显示在“StyleBook”>“配置”页面中。
如果要编辑现有配置包，请选择配置包，然后单击“编辑”。
重用在 StyleBook 外部创建的配置并在配置包之间共享配置
有时，您可能在 StyleBook 外部创建了 NetScaler® 配置，无论是出于特定的操作需求还是旧版设置。现在，您可以将这些以前存在的配置作为 StyleBook 配置包的一部分进行集成和管理，从而实现更灵活和集中的管理。
例如，在此功能推出之前，如果 NetScaler 已配置 SSL Profile，并且 StyleBook 的配置包操作尝试创建同名的 SSL Profile，则配置包操作将因“资源已存在”错误而失败。现在，启用此功能后，配置包操作将成功，并且可以在新配置包中重用同名的现有 SSL Profile。
同样，您可能还会遇到需要在多个应用程序或配置之间共享网络设置、安全策略或部分应用程序配置等资源的情况。此功能使您能够在多个配置包之间共享配置。
要启用此功能，请按照以下步骤操作：
-
导航到“应用程序”>“配置”>“StyleBook”。
-
在“StyleBook”页面上，选择要用于创建新配置包的 StyleBook，或选择与您正在编辑的配置包关联的 StyleBook。
-
在“选择操作”中，单击“配置设置”。
- 通过选择以下一个或两个选项来调整设置：
- 要启用在 NetScaler 上创建配置时重用现有资源，请选择选项“允许在创建配置时重用 NetScaler 上的现有资源”。
- 要在删除配置时保留 NetScaler 上重用的资源，请选择选项“删除配置时是否保留 NetScaler 上重用的资源？”。此选项会保留最初在 StyleBook 外部创建的资源，即使引用它们的最后一个配置包被删除，也能确保这些资源持续可用。
- 单击“确定”。
更改配置包的 StyleBook
有时，您需要更新 StyleBook 以添加功能或修复问题。如果您已使用旧 StyleBook 创建了配置包，则可能需要更新它们以使用新的更新 StyleBook。要使用新的 StyleBook，请更改配置包的现有 StyleBook。
考虑一个示例 StyleBook example-lb，它在 NetScaler 实例上部署基本负载平衡器配置。然后，您从此 StyleBook 创建一个配置包 CP1。
当您想要使用基本负载平衡器配置来配置监视器时，您需要一个新的 StyleBook。因此，请创建 example-lb-mon StyleBook，其中包含配置监视器以及基本负载平衡器配置的功能。
创建 StyleBook 后，更新现有配置包 CP1 以添加一些监视器。为此，请执行以下操作：
-
导航到“应用程序”>“StyleBooks”>“配置”。
-
选择要更改其 StyleBook 的配置包。
在此示例中，从列表中选择 CP1。
-
单击“更改 StyleBook”。
-
从列表中选择所需的 StyleBook。然后，单击“保存选择”。
-
单击“更改”。
在此示例中，从列表中选择 example-lb-mon。
当您更改配置包的 StyleBook 时，新 StyleBook 中的参数结构可能与现有 StyleBook 不同。如果参数结构与以前的 StyleBook 相似，则参数值将自动保留在其各自的字段中。否则，只有在两个 StyleBook 之间具有相同结构的参数才会传输。例如，相同的参数名称、类型、参数父级等。
如果新 StyleBook 中添加了新的必需参数，则在更改 StyleBook 后，您必须手动指定这些参数的值。
在此示例中，example-lb StyleBook 的配置页面上显示的参数如下：
新 example-lb-mon StyleBook 的配置页面上显示的参数如下：
在这种情况下，StyleBook 会保留基本负载平衡器配置的旧值，因为新 StyleBook 未更改现有参数。它只添加了新参数。对于监视器参数，请手动指定所需值。
-
在“目标实例”中，查看所选实例并在必要时更新列表。
-
单击“试运行”。
“对象”页面显示从 NetScaler 实例创建、修改或删除的对象。
-
单击“确定”。
在“StyleBook”>“配置”页面中，“StyleBook 名称”列显示所选配置包的新 StyleBook 名称。在此示例中，它显示 example-lb-mon。
更改具有多个配置包的 StyleBook
当您更改具有多个配置包的现有 StyleBook 时，请执行以下操作：
-
将新的 StyleBook 导入 NetScaler Console。
通常，新的 StyleBook 具有与现有 StyleBook 相同的名称和命名空间，但版本更高。但是，如果名称、命名空间或版本不同，则可以跳过此步骤。
-
更改与现有 StyleBook 关联的配置包的 StyleBook。
仅当所选配置包与同一 StyleBook 关联时，才能选择“更改 StyleBook”。
对于所选配置包，当满足以下条件时，NetScaler Console 会成功更改 StyleBook：
-
现有 StyleBook 的所有配置参数都必须存在于所选 StyleBook 中。
-
所选 StyleBook 中的新参数是可选的。
要查看所选配置包的进度，请在“配置”页面中选择“正在进行/失败的配置”。
-
-
一旦所有配置包都绑定到新的 StyleBook，就从 NetScaler Console 中删除旧的 StyleBook。
导出或导入配置包
您可以像 StyleBook 一样导出或导入配置包。借助此功能，您可以轻松地将 StyleBook 配置共享到另一个 NetScaler Console。当您导出配置包时，一个 tgz 或 zip 捆绑包将下载到您的本地计算机。此捆绑包包含一个 JSON 文件，其中包含配置包中定义的所有参数。
导出配置
要导出配置包，请执行以下操作：
-
导航到“应用程序”>“StyleBooks”>“配置”。
-
选择要导出的配置包。
-
在“选择操作”中，选择“导出配置”。
-
在“导出配置”窗格中，指定以下内容：
-
部署配置的目标实例信息：选择此选项可将目标实例信息包含在导出捆绑包中。
-
与配置关联的 StyleBook：选择此选项可将 StyleBook 包含在导出捆绑包中。
-
用于保护导出配置数据的密码：指定一个密码以加密导出捆绑包。此密码可保护配置包的敏感数据。
-
压缩文件类型：选择 ZIP 或 TGZ 文件类型。
-
-
单击“导出”。
将导出捆绑包保存到本地计算机。
导入配置
您可以将配置包从本地计算机导入到另一个 NetScaler Console。要导入配置包，请执行以下操作：
-
导航到“应用程序”>“StyleBooks”>“配置”。
-
选择“导入配置”。
-
从计算机中选择导入文件捆绑包。
-
使用您在导出期间指定的密码。
-
可选，在“高级选项”中，选择“仅当所有配置对象已存在于 NetScaler 上时才允许创建新配置”。
此选项不会更改已在 NetScaler 实例上创建的对象。
假设您在两个 NetScaler Console 服务器中添加了相同的 NetScaler 实例。并且，您想要将配置包从一个 NetScaler Console 服务器迁移到另一个服务器。使用此选项可以导入配置包，而无需更改其在 NetScaler 实例上的配置对象。
重要提示
要使用此选项，请确保指定的配置捆绑包包含目标实例信息。请参阅导出配置。
仅当所有对象都存在于目标实例上时，此选项才会迁移配置。
-
单击“导入”。
当您导入配置包时，NetScaler Console 会验证以下内容：
-
关联的 StyleBook：如果关联的 StyleBook 不在 NetScaler Console 中，它将随配置包一起导入 StyleBook。
-
目标实例：检查目标实例并在指定的目标实例上部署配置。如果 NetScaler Console 中不存在提及的 NetScaler 实例，则导入配置包时不会包含目标实例。
-
源 NetScaler Console：如果您在同一 NetScaler Console 服务器上导入配置包，则所选捆绑包会更新现有配置包。
将配置包另存为草稿
配置包中的“另存为草稿”选项允许您将配置更改另存为草稿。此功能会保存更改，而不会立即将其部署到 NetScaler 实例。
要将配置包另存为草稿：
- 导航到“应用程序”>“配置”>“配置包”。
- 在“配置”页面上，单击“添加”。
- 选择所需的 StyleBook，然后单击“选择”。
- 在“创建配置”页面上，单击“另存为草稿”。
配置包另存为草稿后，您的配置更改不会直接部署到 NetScaler 实例。相反，配置包将作为草稿存储在“待处理配置”下的“草稿配置”选项卡中。
在“草稿配置”选项卡中，选择配置包以执行以下操作：
- 编辑配置包的配置。
- 将配置部署到 NetScaler 实例。
- 删除草稿以删除配置而不进行部署。
您还可以安排何时部署保存的草稿。
有关详细信息，请参阅安排配置包。
为配置包创建计划
默认情况下，当您创建配置包时，配置包会自动部署到 NetScaler 实例。借助此功能，您可以安排何时部署配置包。
要为配置包创建计划：
- 导航到“应用程序”>“配置”>“配置包”。
- 在“配置”页面上，单击“添加”。
- 选择 StyleBook，然后单击“选择”。
- 在“创建配置”页面上的“执行”下，从“执行模式”列表中选择“稍后”。
- 选择所需的计划时间日期，然后单击“提交”。
所有计划的配置都存储在“待处理配置”下的“计划配置”选项卡中。您可以选择创建的计划来编辑、部署或取消计划。
对于已部署的配置包
您还可以创建计划来编辑和删除已部署的配置包。
安排配置包的编辑操作
要创建计划以编辑已部署的配置包：
- 导航到“应用程序”>“配置”>“配置包”。
- 在“配置”页面上，选择 StyleBook，然后单击“编辑”。
- 在“编辑配置”页面上，编辑配置包。
- 在“执行模式”列表中，选择“稍后”。
- 选择所需的计划时间日期，然后单击“提交”。
安排配置包的删除操作
要创建计划以删除已部署的配置包：
- 导航到“应用程序”>“配置”>“配置包”。
- 在“配置”页面上，选择 StyleBook，然后单击“删除”。
- 在“执行模式”列表中，选择“稍后”。
- 选择所需的计划时间日期，然后单击“提交”。
从配置包中分离目标实例
要从配置包中分离目标实例，请执行以下操作：
-
导航到“应用程序”>“配置”>“配置包”。
-
选择包含要删除的目标实例的配置包。
-
在“选择操作”中，选择“分离目标”。
-
在“分离目标”窗格中，选择要从配置包中删除的目标实例。
-
单击“确定”。
将显示一条消息，确认已创建目标实例已删除的重复配置包。
构建您的 StyleBook
example-lb StyleBook 的完整内容如下所示，供您参考：
name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
-
namespace: com.citrix.adc.stylebooks
prefix: stlb
version: "1.0"
parameters-default-sources:
- stlb::lb
components:
-
name: lb-comp
type: stlb::lb
description: Uses the default lb StyleBook to build the typical lb configuration objects
properties-default-sources:
- $parameters
<!--NeedCopy-->
example-lb-mon StyleBook 的完整内容如下所示，供您参考：
name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
prefix: ns
version: "10.5"
-
namespace: com.citrix.adc.stylebooks
prefix: stlb
version: "1.0"
-
namespace: com.citrix.adc.commontypes
prefix: cmtypes
version: "1.0"
parameters-default-sources:
- stlb::lb
parameters:
-
name: monitors
label: "List of Monitors"
description: "List of Monitors to monitor Application Servers"
type: cmtypes::monitor[]
substitutions:
mon-name(appname, monname): $appname + "-mon-" + $monname
components:
-
name: lb-comp
type: stlb::lb
description: Uses the default lb StyleBook to build the typical lb configuration objects
properties-default-sources:
- $parameters
-
name: monitors-comp
type: cmtypes::monitor
condition: $parameters.monitors
repeat: $parameters.monitors
repeat-item: mon
repeat-index: ndx
description: Builds a list of NetScaler monitor objects and binds them to the servicegroup of this LB config
properties-default-sources:
- $mon
properties:
monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
components:
-
name: monitor-svcg-binding-comp
condition: $parameters.svc-servers
type: ns::servicegroup_lbmonitor_binding
properties:
servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
monitor_name: $parent.properties.monitorname
<!--NeedCopy-->