创建和编辑配置包

在 NetScaler 控制台中,您可以从样书创建配置包。 并且,配置包与创建它的样书相关联。 配置包的更新是通过与其绑定的样书进行的。

创建配置包

执行以下操作从样书创建配置包:

  1. 导航到 应用程序 > StyleBooks > 配置

  2. 单击 添加

  3. 选择样书中,选择要从中创建配置包的所需样书。

    此页面将样本分为默认样本和自定义样本。 选择相应的选项卡来查找所需的样本。

  4. 指定所需的详细信息,例如应用程序名称、IP 地址、端口或协议类型。

    各个样书的 GUI 字段有所不同。

  5. 目标实例中,选择要运行配置的实例或实例组。

笔记:

可以根据需要指定多个目标实例,在多个 NetScaler 上部署配置。

  1. 点击 Dry Run

    对象 页面显示从 NetScaler 实例创建、修改或删除的对象。

  2. 点击 创建

    配置包出现在 StyleBook > Configurations 页面中。

如果要编辑现有的配置包,请选择该配置包并单击 编辑

重复使用在样书之外创建的配置并在 ConfigPack 之间共享配置

有时,您可能在 Stylebook 之外创建了 NetScaler 配置,无论是由于特定的操作需求还是遗留设置。 您现在可以将这些先前存在的配置作为 Stylebook 配置包的一部分进行集成和管理,从而实现更灵活和集中的管理。

例如,在此功能之前,如果 NetScaler 已经配置了 SSL 配置文件,并且如果 StyleBook 的配置包操作尝试创建具有相同名称的 SSL 配置文件,则配置包操作将失败并出现“资源已存在”错误。 现在启用此功能后,configpack 操作成功,并且可以在新的配置包中重复使用具有相同名称的现有 SSL 配置文件。

同样,您可能还会面临跨多个应用程序或配置需要网络设置、安全策略或部分应用程序配置等资源的情况。 此功能使您能够跨多个配置包共享配置。

要启用此功能,请按照以下步骤操作:

  1. 导航到应用程序 > 配置 > 样式手册。

  2. 在 Stylebooks 页面上,选择您将用于创建新配置包的 Stylebook 或与您正在编辑的配置包相关联的 Stylebook。

  3. 在“选择操作”中,单击“配置设置”。 配置设置选项

    配置样本设置选项

  4. 通过选择以下一个或两个选项来调整设置:
  5. 单击 确定

更改配置包的样本

有时,您需要更新样书以添加功能或修复问题。 如果您已经使用旧样书创建了配置包,您可能需要更新它们以使用新更新的样书。 要使用新的样本,请更改配置包的现有样本。

考虑一个示例 StyleBook example-lb ,它在 NetScaler 实例上部署了一个基本的负载均衡器配置。 并且,您可以从此样本中创建配置包 CP1。

当您想要使用基本负载平衡器配置来配置监视器时,您需要一个新的样书。 因此,创建 example-lb-mon StyleBook,其中包括配置监视器以及基本负载均衡器配置的能力。

创建样书后,更新现有的配置包 CP1 以添加一些监视器。 为此,请执行以下操作:

  1. 导航到 应用程序 > StyleBooks > 配置

  2. 选择您想要更改样本的配置包。

    在此示例中,从列表中选择 CP1。

  3. 单击 更改样式簿

  4. 从列表中选择所需的样本。 然后,点击 保存选择

  5. 单击 更改

    在此示例中,从列表中选择 example-lb-mon

    当您更改配置包的样本时,新样本中的参数可能与现有样本具有不同的结构。 如果参数结构与之前的样书类似,则参数的值会自动保留在各自的字段中。 否则,仅传输两个样书之间具有相同结构的参数。 例如相同的参数名称、类型、参数父级等等。

    更改配置包的样本

    如果在新的样本中添加了新的必需参数,则在更改样本后,必须手动指定这些参数的值。

    在此示例中, example-lb StyleBook 的配置页面上显示的参数如下:

    负载平衡配置包示例

    example-lb-mon StyleBook 的配置页面上显示的参数如下:

    配置包迁移后的示例参数

    在这种情况下,样书会保留基本负载均衡器配置的旧值,因为新的样书尚未更改现有参数。 并且,它只添加了新的参数。 对于监视参数,手动指定所需的值。

  6. 目标实例中,查看所选实例并在必要时更新列表。

  7. 点击 Dry Run

    对象 页面显示从 NetScaler 实例创建、修改或删除的对象。

  8. 单击 确定

    StyleBook > Configurations 页面中, StyleBook Name 列显示所选配置包的新 StyleBook 名称。 在这种情况下,它显示 example-lb-mon

更改具有多个配置包的样书

更改具有多个配置包的现有样本时,请执行以下操作:

  1. 将新的样本导入 NetScaler 控制台。

    通常,新的样书具有相同的名称和命名空间,但版本高于现有的样书。 但是,如果名称、命名空间或版本不同,则可以跳过此步骤。

  2. 更改与现有样本关联的配置包的样本。

    仅当选定的配置包与同一样本相关联时,您才可以选择 更改样本

    对于选定的配置包,当满足以下条件时,NetScaler 控制台将成功更改样本:

    要查看所选配置包的进度,请在 配置 页面中选择 正在进行/失败的配置

  3. 将所有配置包绑定到新样书后,从 NetScaler 控制台中删除旧样书。

导出或导入配置包

您可以导出或导入像 StyleBooks 这样的配置包。 利用此功能,您可以轻松地将 StyleBook 配置共享到另一个 NetScaler 控制台。 当您导出配置包时, tgzzip 包将下载到您的本地计算机。 该捆绑包包含一个 JSON 文件,其中所有参数均在配置包中定义。

导出配置

执行以下操作来导出配置包:

  1. 导航到 应用程序 > StyleBooks > 配置

  2. 选择您想要导出的配置包。

  3. 选择操作中,选择 导出配置

    导出配置选项

  4. 导出配置 窗格中,指定以下内容:

    导出配置包

  5. 单击 导出

    将导出包保存在本地计算机上。

导入配置

您可以将配置包从本地计算机导入到不同的 NetScaler 控制台。 要导入配置包,请执行以下操作:

  1. 导航到 应用程序 > StyleBooks > 配置

  2. 选择 导入配置

  3. 从您的计算机中选择导入文件包。

  4. 使用您在导出期间指定的密码。

  5. 可选,在高级选项中,选择 仅当所有配置对象已存在于 NetScaler上时才允许创建新配置。

    此选项不会改变已在 NetScaler 实例上创建的对象。

    假设您在两个 NetScaler 控制台服务器中添加了相同的 NetScaler 实例。 并且,您想要将配置包从一台 NetScaler 控制台服务器迁移到另一台服务器。 使用此选项可以导入配置包,而无需更改 NetScaler 实例上的配置对象。

重要的

要使用此选项,请确保指定的配置包具有目标实例信息。 参见, 导出配置

仅当所有对象都存在于目标实例上时,此选项才会迁移配置。

  1. 单击 导入

导入配置

导入配置包时,NetScaler 控制台会验证以下内容:

将配置包保存为草稿

配置包中的 保存为草稿 选项允许您将配置更改保存为草稿。 此功能会保存更改,而不会立即将其部署到 NetScaler 实例。

要将配置包保存为草稿:

  1. 导航到 应用程序 > 配置 > 配置包
  2. 配置 页面上,单击 添加
  3. 选择您想要的样式簿并单击 选择
  4. 创建配置 页面上,单击 保存为草稿

保存为草稿

一旦配置包保存为草稿,您的配置更改就不会直接部署到 NetScaler 实例。 相反,配置包作为草稿存储在 草稿配置 选项卡下的 待定配置中。

Draft Configurations 选项卡中,选择配置包执行以下操作:

草稿配置

您还可以安排何时部署已保存的草稿。

有关更多信息,请参阅 安排配置包

为配置包创建时间表

创建配置包时,默认情况下配置包会自动部署到 NetScaler 实例。 使用此功能,您可以安排何时部署配置包。

要为配置包创建时间表:

  1. 导航到 应用程序 > 配置 > 配置包
  2. 配置 页面上,单击 添加
  3. 选择 StyleBook 并单击 选择
  4. 创建配置 页面上,在 执行下,从 执行模式 列表中选择 稍后
  5. 选择所需的安排时间和日期,然后单击 提交

执行模式

所有计划配置都存储在 计划配置 选项卡下的 待定配置中。 您可以选择已创建的计划,对计划进行编辑、部署或取消操作。

预定配置

对于已部署的配置包

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

安排配置包的编辑操作

要创建计划来编辑已部署的配置包:

  1. 导航到 应用程序 > 配置 > 配置包
  2. 配置 页面上,选择一个样本簿并单击 编辑
  3. 编辑配置 页面上,编辑配置包。
  4. 执行模式 列表中,选择 稍后
  5. 选择所需的安排时间和日期,然后单击 提交

安排配置包的删除操作

要创建删除已部署的配置包的计划:

  1. 导航到 应用程序 > 配置 > 配置包
  2. 配置页面上,选择一个样书并单击 删除
  3. 执行模式 列表中,选择 稍后
  4. 选择所需的安排时间和日期,然后单击 提交

从配置包中分离目标实例

要从配置包中分离目标实例,请执行以下操作:

  1. 导航到 应用程序 > 配置 > 配置包

  2. 选择要删除的目标实例的配置包。

  3. 选择操作中,选择 分离目标

  4. 分离目标 窗格中,选择要从配置包中删除的目标实例。

    分离目标

  5. 单击 确定

显示一条消息,确认创建重复配置包,并且目标实例现已删除。

建立你的样本

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-->