创建和编辑配置包

Last published : Oct 06, 2026
在 NetScaler Console 中，您可以从 StyleBook 创建配置包。配置包与其创建的 StyleBook 绑定。配置包的更新通过其绑定的 StyleBook 进行。
Related information
创建和使用自定义 StyleBook

创建配置包

执行以下操作以从 StyleBook 创建配置包：
  1. 导航到 应用程序 > StyleBooks > 配置。
  2. 单击 添加。
  3. 在 选择 StyleBooks 中，选择要从中创建配置包所需的 StyleBooks。
    此页面将 StyleBooks 分为默认 StyleBooks 和自定义 StyleBooks。选择相应的选项卡以查找所需的 StyleBooks。
  4. 指定所需详细信息，例如应用程序名称、IP 地址、端口或协议类型。
    GUI 字段因 StyleBook 而异。
  5. 在 目标实例 中，选择要运行配置的实例或实例组。
    注意：
    您可以通过指定所需数量的目标实例，将配置部署到多个 NetScaler 上。
  6. 单击 试运行。
    对象 页面显示从 NetScaler 实例创建、修改或删除的对象。
  7. 点击 创建
    配置包显示在 StyleBook > Configurations 页面中。
如果要编辑现有配置包，请选择配置包，然后点击 编辑。

重用在 StyleBooks 外部创建的配置并在 ConfigPacks 之间共享配置

有时，您可能在 Stylebooks 之外创建了 NetScaler® 配置，无论是由于特定的操作需求还是旧版设置。您现在可以将这些以前存在的配置作为 Stylebook 配置包的一部分进行集成和管理，从而实现更灵活和集中的管理。
例如，在此功能之前，如果 NetScaler 已配置 SSL 配置文件，并且 StyleBook 的配置包操作尝试创建同名的 SSL 配置文件，则配置包操作将因“资源已存在”错误而失败。现在，启用此功能后，配置包操作会成功，并且同名的现有 SSL 配置文件可以在新配置包中重用。
同样，您可能还会遇到网络设置、安全策略或部分应用程序配置等资源在多个应用程序或配置中都需要的情况。此功能使您能够在多个配置包之间共享配置。
要启用此功能，请按照以下步骤操作：
  1. 导航到 应用程序 > 配置 > Stylebooks。
  2. 在 Stylebooks 页面上，选择您将用于创建新配置包的 Stylebook，或与您正在编辑的配置包关联的 Stylebook。
  3. 在“选择操作”中，点击“配置设置”。 Configure Settings option
    配置 Stylebooks 设置选项
  4. 通过选择以下一个或两个选项来调整设置：
    • 要在创建配置时启用 NetScaler 上现有资源的重用，请选择选项 允许在创建配置时重用 NetScaler 上的现有资源。
    • 要在删除配置时保留 NetScaler 上重用的资源，请选择选项 删除配置时是否保留 NetScaler 上重用的资源？。此选项会在 NetScaler 上保留最初在 Stylebooks 之外创建的资源，即使引用它们的最后一个配置包被删除，从而确保其持续可用性。
  5. 点击 确定。

更改配置包的 StyleBook

有时，您需要更新 StyleBook 以添加功能或修复问题。如果您已经使用旧的 StyleBook 创建了配置包，您可能希望更新它们以使用新的更新后的 StyleBook。要使用新的 StyleBook，请更改配置包的现有 StyleBook。
考虑一个示例 StyleBook example-lb，它在 NetScaler 实例上部署基本的负载均衡器配置。然后，您从此 StyleBook 创建一个配置包 CP1。
当您想要使用基本的负载均衡器配置来配置监视器时，您需要一个新的 StyleBook。因此，创建 example-lb-mon StyleBook，它包含配置监视器以及基本负载均衡器配置的功能。
创建 StyleBook 后，更新现有配置包 CP1 以添加一些监视器。为此，请执行以下操作：
  1. 导航到 应用程序 > StyleBooks > 配置。
  2. 选择您要更改其 StyleBook 的配置包。
    在此示例中，从列表中选择 CP1。
  3. 点击 更改 StyleBook。
  4. 从列表中选择所需的 StyleBook。然后，点击 保存选择。
  5. 点击 更改。
    在此示例中，从列表中选择 example-lb-mon。
    当您更改配置包的 StyleBook 时，新 StyleBook 中的参数结构可能与现有 StyleBook 不同。如果参数结构与之前的 StyleBook 相似，参数值将自动保留在其各自的字段中。否则，只有在两个 StyleBook 之间具有相同结构的参数才会被传输。例如，相同的参数名称、类型、参数父级等。
    更改配置包的 StyleBook
    如果在新 StyleBook 中添加了新的必需参数，更改 StyleBook 后，您必须手动指定这些参数的值。
    在此示例中，example-lb StyleBook 的配置页面上显示的参数如下：
    负载均衡配置包示例(/en-us/netscaler-application-delivery-management-software/media/nmas-migrate-configpack-3.png)
    新的 example-lb-mon StyleBook 的配置页面上显示的参数如下：
    配置包迁移后的参数示例(/en-us/netscaler-application-delivery-management-software/media/nmas-migrate-configpack-4.png)
    在这种情况下，StyleBook 会保留基本负载均衡器配置的旧值，因为新的 StyleBook 未更改现有参数。它只添加了新参数。对于监视器参数，请手动指定所需值。
  6. 在目标实例中，查看所选实例并在必要时更新列表。
  7. 单击试运行。
    对象页面显示从 NetScaler 实例创建、修改或删除的对象。
  8. 单击确定。
    在StyleBook > 配置页面中，StyleBook 名称列显示所选配置包的新 StyleBook 名称。在此示例中，它显示 example-lb-mon。

更改具有多个配置包的 StyleBook

更改具有多个配置包的现有 StyleBook 时，请执行以下操作：
  1. 将新的 StyleBook 导入 NetScaler Console。
    通常，新的 StyleBook 具有与现有 StyleBook 相同的名称和命名空间，但版本更高。但是，如果名称、命名空间或版本不同，则可以跳过此步骤。
  2. 更改与现有 StyleBook 关联的配置包的 StyleBook。
    仅当所选配置包与同一 StyleBook 关联时，才能选择“更改 StyleBook”。
    对于所选配置包，当满足以下条件时，NetScaler Console 会成功更改 StyleBook：
    • 现有 StyleBook 的所有配置参数都必须存在于所选 StyleBook 中。
    • 所选 StyleBook 中的新参数是可选的。
    要查看所选配置包的进度，请在“配置”页面中选择“正在进行/失败的配置”。
  3. 一旦所有配置包都绑定到新的 StyleBook，请从 NetScaler Console 中删除旧的 StyleBook。

导出或导入配置包

您可以像 StyleBook 一样导出或导入配置包。借助此功能，您可以轻松地将 StyleBook 配置共享到另一个 NetScaler Console。导出配置包时，tgz 或 zip 捆绑包会下载到您的本地计算机。此捆绑包包含一个 JSON 文件，其中包含配置包中定义的所有参数。

导出配置

要导出配置包，请执行以下操作：
  1. 导航到“应用程序 > StyleBooks > 配置”。
  2. 选择要导出的配置包。
  3. 在“选择操作”中，选择“导出配置”。
    导出配置选项
  4. 在“导出配置”窗格中，指定以下内容：
    • 部署配置的目标实例信息：选择此选项可将目标实例的信息包含在导出包中。
    • 与配置关联的 StyleBook：选择此选项可将 StyleBook 包含在导出包中。
    • 用于保护导出配置数据的密码：指定一个密码来加密导出包。此密码可保护配置包的敏感数据。
    • 压缩文件类型：选择 ZIP 或 TGZ 文件类型。
    导出配置包
  5. 单击“导出”。
    将导出包保存到本地计算机上。

导入配置

您可以将配置包从本地计算机导入到其他 NetScaler Console。要导入配置包，请执行以下操作：
  1. 导航到“应用程序 > StyleBooks > 配置”。
  2. 选择“导入配置”。
  3. 从计算机中选择导入文件包。
  4. 使用您在导出期间指定的密码。
  5. 可选，在“高级选项”中，选择“仅当所有配置对象已存在于 NetScaler 上时才允许创建新配置”。
    此选项不会更改已在 NetScaler 实例上创建的对象。
    假设您在两个 NetScaler Console 服务器中添加了相同的 NetScaler 实例。并且，您想要将配置包从一个 NetScaler Console 服务器迁移到另一个服务器。使用此选项可以导入配置包，而无需更改其在 NetScaler 实例上的配置对象。
    重要
    要使用此选项，请确保指定的配置包包含目标实例信息。请参阅导出配置。
    仅当所有对象都存在于目标实例上时，此选项才会迁移配置。
  6. 单击“导入”。
导入配置
导入配置包时，NetScaler Console 会验证以下内容：
  • 关联的 StyleBook：如果关联的 StyleBook 不在 NetScaler Console 中，它会随配置包一起导入 StyleBook。
  • 目标实例：检查目标实例并在指定的目标实例上部署配置。如果 NetScaler Console 中不存在提及的 NetScaler 实例，则导入配置包时不会包含目标实例。
  • 源 NetScaler Console：如果您在同一 NetScaler Console 服务器上导入配置包，则所选捆绑包会更新现有配置包。

将配置包另存为草稿

配置包中的“另存为草稿”选项允许您将配置更改另存为草稿。此功能会保存更改，而不会立即将其部署到 NetScaler 实例。
要将配置包另存为草稿：
  1. 导航到“应用程序 > 配置 > 配置包”。
  2. 在“配置”页面上，单击“添加”。
  3. 选择所需的样式簿，然后单击“选择”。
  4. 在“创建配置”页面上，单击“另存为草稿”。
另存为草稿
将配置包另存为草稿后，您的配置更改不会直接部署到 NetScaler 实例。相反，配置包将作为草稿存储在“待处理配置”下的“草稿配置”选项卡中。
在“草稿配置”选项卡中，选择配置包以执行以下操作：
  • 编辑配置包的配置。
  • 将配置部署到 NetScaler 实例。
  • 删除草稿以在不部署的情况下移除配置。
草稿配置
您还可以安排何时部署已保存的草稿。
有关详细信息，请参阅安排配置包。

为配置包创建计划

创建配置包时，配置包默认会自动部署到 NetScaler 实例。借助此功能，您可以安排何时部署配置包。
要为配置包创建计划：
  1. 导航到 应用程序 > 配置 > 配置包。
  2. 在 配置 页面上，单击 添加。
  3. 选择 StyleBook 并单击 选择。
  4. 在 创建配置 页面上，在 执行 下，从 执行模式 列表中选择 稍后。
  5. 选择所需的调度时间和日期，然后单击 提交。
执行模式
所有计划的配置都存储在 待处理配置 下的 计划的配置 选项卡中。您可以选择已创建的计划来编辑、部署或取消该计划。
计划的配置

对于已部署的配置包

您还可以创建计划以编辑和删除已部署的配置包。

计划配置包的编辑操作

要创建编辑已部署配置包的计划：
  1. 导航到 应用程序 > 配置 > 配置包。
  2. 在 配置 页面上，选择一个 StyleBook 并单击 编辑。
  3. 在 编辑配置 页面上，编辑配置包。
  4. 在“执行模式”列表中，选择“稍后”。
  5. 选择所需的计划时间和日期，然后单击“提交”。

计划配置包的删除操作

要创建计划以删除已部署的配置包：
  1. 导航到“应用程序 > 配置 > 配置包”。
  2. 在“配置页面”上，选择一个 StyleBook，然后单击“删除”。
  3. 在“执行模式”列表中，选择“稍后”。
  4. 选择所需的计划时间和日期，然后单击“提交”。

从配置包中分离目标实例

要从配置包中分离目标实例，请执行以下操作：
  1. 导航到“应用程序 > 配置 > 配置包”。
  2. 选择包含要删除的目标实例的配置包。
  3. 在“选择操作”中，选择“分离目标”。
  4. 在“分离目标”窗格中，选择要从配置包中删除的目标实例。
    分离目标
  5. 点击 OK。
显示一条消息，确认已创建重复的配置包，并已移除目标实例。

构建您的 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
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