创建和编辑配置包
在 NetScaler Console 中，您可以从 StyleBook 创建配置包。配置包与其创建的 StyleBook 绑定。对配置包的任何更新都通过其绑定的 StyleBook 进行。
创建配置包
要从 StyleBook 创建配置包，请执行以下操作：
-
导航到 应用程序 > 配置 > 配置包。
-
单击 添加。
-
在 选择 StyleBook 中，选择要从中创建配置包的所需 StyleBook。此页面将 StyleBook 分为默认、企业和自定义 StyleBook。选择相应的选项卡以查找所需的 StyleBook。
-
（可选）为您的配置包指定一个唯一的 配置密钥。此密钥将作为此配置包的 显示密钥。
-
如果您指定的 配置密钥 已存在，NetScaler Console 将无法创建配置包。
-
如果您未指定 配置密钥，NetScaler Console 会自动分配 配置包 ID。但是，此值不会显示为 显示密钥。
-
如果您未指定 配置密钥，并且任何 StyleBook 参数已设置
key属性，则该参数值将显示为 显示密钥。有关更多信息，请参阅参数。
-
-
指定所需的详细信息，例如应用程序名称、IP 地址、端口或协议类型。GUI 字段因 StyleBook 而异。
-
在 目标实例 中，选择要运行配置的实例或实例组。注意：您可以通过指定所需数量的目标实例，在多个 NetScaler 上部署配置。
-
单击试运行。对象页面显示从 NetScaler 实例创建、修改或删除的对象。
-
单击创建配置包显示在StyleBook > 配置页面中。
如果要编辑现有配置包，请选择配置包并单击编辑。
重用在 StyleBooks 外部创建的配置并在 ConfigPacks 之间共享配置
有时，您可能在 Stylebooks 之外创建了 NetScaler® 配置，无论是由于特定的操作需求还是旧版设置。您现在可以将这些以前存在的配置作为 Stylebook 配置包的一部分进行集成和管理，从而实现更灵活和集中的管理。
例如，在此功能之前，如果 NetScaler 已配置 SSL 配置文件，并且 StyleBook 的配置包操作尝试创建同名的 SSL 配置文件，则配置包操作将因“资源已存在”错误而失败。现在，启用此功能后，配置包操作将成功，并且同名的现有 SSL 配置文件可以在新配置包中重用。
同样，您可能还会遇到以下情况：多个应用程序或配置需要网络设置、安全策略或部分应用程序配置等资源。此功能使您能够在多个配置包之间共享配置。
要启用此功能，请执行以下步骤：
-
导航到应用程序 > 配置 > Stylebooks。
-
在Stylebooks页面上，选择用于创建新配置包的 Stylebook 或与您正在编辑的配置包关联的 Stylebook。
-
在选择操作中，单击配置设置。
-
通过选择以下一个或两个选项来调整设置：
-
要在创建配置时启用 NetScaler 上现有资源的重用，请选择选项 允许在创建配置时重用 NetScaler 上的现有资源。
-
要在删除配置时保留 NetScaler 上重用的资源，请选择选项 删除配置时保留 NetScaler 上重用的资源？。此选项会保留最初在样式簿之外在 NetScaler 上创建的资源，即使引用它们的最后一个配置包被删除，也能确保它们持续可用。
-
-
单击 确定。
更改配置包的样式簿
有时，您需要更新样式簿以添加功能或修复问题。如果您已经使用旧样式簿创建了配置包，您可能希望更新它们以使用新的更新样式簿。要使用新的样式簿，请更改配置包的现有样式簿。
考虑一个示例样式簿 example-lb，它在 NetScaler 实例上部署基本的负载均衡器配置。然后，您从此样式簿创建配置包 CP1。
要使用基本的负载均衡器配置来配置监视器，您需要一个新的样式簿。为此，请创建一个 example-lb-mon 样式簿，其中包含配置监视器以及基本负载均衡器配置的功能。
创建样式簿后，更新现有配置包 CP1 以添加监视器。要更新配置包，请执行以下操作：
-
导航到 应用程序 > 配置 > 配置包。
-
选择要更改样式簿的配置包。在此示例中，从列表中选择 CP1。
-
单击 更改样式簿。
-
从列表中选择所需的 StyleBook。然后，点击 保存选择。
-
点击 更改。在此示例中，从列表中选择 example-lb-mon。更改配置包的 StyleBook 时，新 StyleBook 中的参数结构可能与现有 StyleBook 不同。如果参数结构与之前的 StyleBook 相似，则参数值将自动保留在其各自的字段中。否则，只有在两个 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 文件，其中包含配置包中定义的所有参数。
导出配置
执行以下操作以导出配置包：
-
导航到 应用程序 > 配置 > 配置包。
-
选择要导出的配置包。
-
在 选择操作 中，选择 导出配置。导出配置选项(/en-us/netscaler-console-service/media/export-configuration-pack.png)
-
在 导出配置 窗格中，指定以下内容：
-
部署配置的目标实例信息：选择此选项可将目标实例信息包含在导出包中。
-
与配置关联的 StyleBook：选择此选项可将 StyleBook 包含在导出包中。
-
用于保护导出配置数据的密码：指定一个密码来加密导出包。此密码可保护配置包的敏感数据。
-
压缩文件类型：选择 ZIP 或 TGZ 文件类型。
导出配置包(/en-us/netscaler-console-service/media/export-configuration-options.png) -
-
单击 导出。将导出包保存到本地计算机。
导入配置
您可以将配置包从本地计算机导入到其他 NetScaler Console 服务器。要导入配置包，请执行以下操作：
-
导航到 应用程序 > 配置 > 配置包。
-
选择 导入配置。
-
从您的计算机中选择导入文件包。
-
使用您在导出期间指定的密码。
-
（可选）在“高级选项”中，选择 仅当所有配置对象已存在于 NetScaler 上时才允许创建新配置。此选项不会更改已在 NetScaler 实例上创建的对象。假设您在两个 NetScaler Console 服务器中添加了相同的 NetScaler 实例。并且，您希望将配置包从一个 NetScaler Console 服务器迁移到另一个服务器。使用此选项可以导入配置包，而无需更改其在 NetScaler 实例上的配置对象。重要提示：要使用此选项，请确保指定的配置包包含目标实例信息。请参阅 Export configuration。仅当所有对象都存在于目标实例上时，此选项才会迁移配置。
-
单击 Import。
导入配置包时，NetScaler Console 会验证以下内容：
-
关联的 StyleBook：如果关联的 StyleBook 不在 NetScaler Console 中，它会随配置包一起导入 StyleBook。
-
目标实例：检查目标实例并在指定的目标实例上部署配置。如果 NetScaler Console 中不存在提及的 NetScaler 实例，则导入配置包时将不包含目标实例。
-
源 NetScaler Console：如果您在同一 NetScaler Console 服务器上导入配置包，则所选捆绑包会更新现有配置包。
将配置包另存为草稿
配置包中的“另存为草稿”选项允许您将配置更改另存为草稿。此功能会保存更改，而不会立即将其部署到 NetScaler 实例。
要将配置包另存为草稿，请执行以下步骤：
-
导航到“应用程序 > 配置 > 配置包”。
-
在“配置”页面上，单击“添加”。
-
选择所需的样式簿，然后单击“选择”。
-
在“创建配置”页面上，单击“另存为草稿”。
配置包另存为草稿后，您的配置更改不会直接部署到 NetScaler 实例。相反，配置包将作为草稿存储在“待处理配置”下的“草稿配置”选项卡中。
在“草稿配置”选项卡中，选择配置包以执行以下操作：
-
编辑草稿的配置。
-
将配置部署到 NetScaler 实例。
-
删除草稿。
您还可以安排何时部署已保存的草稿。
有关详细信息，请参阅 为配置包创建计划。
为配置包创建计划
当您创建配置包时，配置包默认会自动部署到 NetScaler 实例。借助此功能，您可以安排配置包的部署。
要为配置包创建计划，请按照以下步骤操作：
-
导航到 应用程序 > 配置 > 配置包。
-
在 配置 页面上，单击 添加。
-
选择 StyleBook，然后单击 选择。
-
在 创建配置 页面上，在 执行 下，从 执行模式 列表中选择 稍后。
-
选择所需的计划时间和日期，然后单击 提交。
所有计划的配置都存储在 待处理配置 下的 计划配置 选项卡中。您可以选择已创建的计划来编辑配置参数、部署或取消计划。
注意：
部署计划的配置包会取消计划并立即执行配置。
对于已部署的配置包
您还可以创建计划来编辑和删除已部署的配置包。
计划配置包的编辑操作
要创建计划以编辑已部署的配置包，请按照以下步骤操作：
-
导航到 应用程序 > 配置 > 配置包。
-
在 配置 页面上，选择一个 StyleBook，然后单击 编辑。
-
在 编辑配置 页面上，编辑配置包。
-
在 执行模式 列表中，选择 稍后。
-
选择所需的计划时间和日期，然后单击 提交。
计划配置包的删除操作
要创建计划以删除已部署的配置包，请按照以下步骤操作：
-
导航到 应用程序 > 配置 > 配置包。
-
在 配置 页面上，选择一个 StyleBook，然后单击 删除。
-
在 执行模式 列表中，选择 稍后。
-
选择所需的计划时间和日期，然后单击 确定。
从配置包中分离目标实例
要从配置包中分离目标实例，请执行以下操作：
-
导航到 应用程序 > 配置 > 配置包。
-
选择包含要删除的目标实例的配置包。
-
在 选择操作 中，选择 分离目标。
-
在 分离目标 窗格中，选择要从配置包中删除的目标实例。
-
单击 确定。
将显示一条消息，确认已创建了一个重复的配置包，其中目标实例已删除。
构建您的 StyleBooks
以下提供了 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
以下提供了 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