创建和编辑配置包

January 29, 2024

投稿者:

在 Citrix Application Delivery Management (ADM) 中，您可以从样书创建配置包。此外，配置包与创建它的样书相关联。配置包的更新是通过与其绑定的样书进行的。

创建配置包

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

导航到 应用程序 > 样书 > 配置。
单击添加。
在 选择样书中，选择要从中创建配置包的所需样书。

此页面将样书分类为默认样书和自定义样书。选择相应的选项卡以查找所需的样书。
指定所需的详细信息，例如应用程序名称、IP 地址、端口或协议类型。

图形用户界面字段因样书而异于另一个样书。
在 目标实例中，选择要运行配置的实例或实例组。

注意：

您可以通过根据需要指定任意数量的目标实例，在多个 Citrix ADC 上部署配置。
单击试运行。

对象页面显示从 Citrix ADC 实例中创建、修改或删除的对象。
单击创建

配置包将显示在 样书 > 配置 页面中。

如果要编辑现有配置包，请选择配置包，然后单击编辑。

更改配置包的样书

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

考虑在 ADC 实例上部署基本负载平衡器配置的样书书示例。而且，您可以从此样书中创建配置包 CP1。

如果要使用基本负载平衡器配置来配置监视器，则需要新的样书。因此，请创建 Example-lb-mon 样书，其中包括配置监视器以及基本负载平衡器配置的功能。

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

导航到 应用程序 > 样书 > 配置。
选择要更改样书的配置包。

在此示例中，从列表中选择 CP1。
单击“更改样书”。
从列表中选择所需的样书。然后，单击“保存选择”。
单击 Change（更改）。

在此示例中，从列表中选择 例子-lb-mon 。

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

如果在新样书中添加了新的必需参数，则在更改样书之后，必须手动指定此类参数的值。

在此示例中，示 例 lb 样书的配置页面上显示的参数如下：

新示 例-lb-mon 样书的配置页面上显示的参数如下：

在这种情况下，样书会保留基本负载平衡器配置的旧值，因为新的样书没有更改现有参数。而且，它只添加了新的参数。对于监视器参数，请手动指定所需的值。
在 目标实例中，查看选定的实例并根据需要更新列表。
单击试运行。

对象页面显示从 Citrix ADC 实例中创建、修改或删除的对象。
单击确定。

在 样书 > 配置 页面中， 样书名称 列显示所选配置包的新样书名称。在这种情况下，它会显示示 例-lb-mon。

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

当您更改具有多个配置包的现有样书时，请执行以下操作：

将新的样书导入 ADM。

通常，新样书的名称和命名空间相同，版本高于现有样书。但是，如果名称、命名空间或版本不同，则可以跳过此步骤。
更改与现有样书关联的配置包的样书。

只有当选定的配置包与同一 样书关联时，才能选择更 改样书。

对于选定的配置包，当满足以下条件时，ADM 将成功更改样书：
- 所选样书中必须包含现有样书的所有配置参数。
- 选定样书中的新参数是可选的。
要查看所选配置包的进度，请在“配置”页面 中选择“正在进行中/失败 的配置”。
一旦所有配置包都绑定到新的样书，将旧的样书从 ADM 中删除。

导出或导入配置包

您可以像样书一样导出或导入配置包。使用此功能，您可以随时将样书配置共享到另一台 ADM 服务器。导出配置包时，tgz 或 zip 捆绑包下载到本地计算机。此捆绑包包含一个 JSON 文件，其中包含配置包中定义的所有参数。

导出配置

执行以下操作以导出配置包：

导航到 应用程序 > 样书 > 配置。
选择要导出的配置包。
在 选择操作中，选择 导出配置。
在“导出配置”窗格中，指定以下内容：
- 部署配置的目标实例信息：选择此选项可在导出捆绑包中包含目标实例的信息。
- 与配置关联的样书：选择此选项可将样书包含在导出包中。
- 用于保护导出配置数据的密码：指定用于加密导出包的密码短语。此密码短语可保护配置包的敏感数据。
- 压缩文件类型：选择 ZIP 或 TGZ 文件类型。
单击导出。

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

导入配置

您可以将配置包从本地计算机导入其他 ADM 服务器。要导入配置包，请执行以下操作：

导航到 应用程序 > 样书 > 配置。
选择 导入配置。
从计算机中选择导入文件包。
使用您在导出期间指定的密码短语。
可选，在“高级选项”中，选择“仅允许创建新配置”（如果 ADC 上已存在所有配置对象）。

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

考虑您在两台 ADM 服务器中添加了相同的 ADC 实例。而且，您希望将配置包从一台 ADM 服务器迁移到另一台服务器。使用此选项可在不更改 ADC 实例上的配置对象的情况下导入配置包。

重要

信息：要使用此选项，请确保指定的配置捆绑包含目标实例信息。请参阅“导出配置”。

只有当目标实例上都存在所有对象时，此选项才迁移配置。
单击导入。

导入配置

导入配置包时，ADM 将验证以下内容：

关联的样书：如果关联的样书不在 ADM 中，它将导入样书和配置包。
目标实例：检查目标实例并在指定的目标实例上部署配置。如果 ADM 中没有提到的 ADC 实例，则导入配置包时不包含目标实例。
源 ADM：如果要在同一台 ADM 服务器上导入配置包，则选定的捆绑包将更新现有的配置包。

构建您的样书

示例磅样书的完整内容如下供您参考：

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

示 例-lb-mon 样书的完整内容如下供参考：

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

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

创建和编辑配置包

January 29, 2024

投稿者:

January 29, 2024

投稿者: