使用 StyleBooks Configuration Builder 迁移 NetScaler 应用程序配置
StyleBooks Configuration Builder 用于将现有 NetScaler 配置迁移到 StyleBooks。此功能还可自动将应用程序配置从一个 NetScaler 实例迁移到另一个实例或 Autoscale 组。
Configuration Builder 提供了一个结构化应用程序 StyleBook，可用于 NetScaler 配置的任何变体。此功能可帮助您开始使用 StyleBooks，而无需深入了解 StyleBooks 语法和构造。否则，需要了解 StyleBooks 语法和构造才能创建 StyleBook。
Configuration Builder 还会创建一个配置包，用于在新 NetScaler 实例上反映相同的 NetScaler 配置。通过此配置包，可以将一个 NetScaler 实例的初始 NetScaler 配置复制到另一个 NetScaler 实例。初始配置源可以是以下之一：
-
NetScaler 实例： 指定托管要复制的应用程序配置的实例。
即使您未指定目标实例，Configuration Builder 也会将 NetScaler 配置转换为 StyleBook 和配置包。稍后，您可以使用此配置包将 NetScaler 配置迁移到其他 NetScaler 实例。
如果目标实例是 Autoscale 组，则配置包将显示在“网络”>“Autoscale 组”页面上的“配置”选项卡下。
-
一组 CLI 命令： 从
ns.conf或Application config粘贴配置。
Configuration Builder 识别嵌入在源配置中的不同应用程序列表。当您选择感兴趣的应用程序配置时，Configuration Builder 会提取所选应用程序的 CLI 命令集。这些 CLI 命令是从源配置中提取的。它还会识别可能需要您输入的部署和配置属性。
-
IP 地址/端口 - 您可以查看和编辑原始配置中虚拟服务器、服务、服务组的成员的 IP 地址和端口。
-
配置文件/密钥 - 这些属性可以是源配置中指定的密码或证书。
指定必要信息后，开始在目标 NetScaler 实例上迁移或复制应用程序配置。
应用程序创建和迁移后，将在 NetScaler Console 中使用 adc_nitro_application StyleBook 创建一个配置包。此 StyleBook 是基于 NetScaler NITRO 资源创建的。此配置包表示目标 NetScaler 实例上的应用程序配置。要查看创建的配置包，请导航到“应用程序”>“配置”>“配置包”。
在已迁移的配置之间共享配置实体
使用配置迁移实用程序迁移配置时，可以重用配置实体。后续迁移成功重用现有配置实体。以前，当迁移共享某些配置实体的两个配置时，配置迁移失败并出现错误 Resource already exists。此选项通过允许在跨多个配置使用配置实体的场景中重用配置实体来简化迁移工作流。
支持的 NetScaler 功能
StyleBook Configuration Builder 识别并支持源配置中的以下 NetScaler 功能：
- 内容切换
- 负载平衡
- 监视
- SSL 卸载
- 速率限制
- 重写
- 响应程序
- Web 应用程序防火墙 (WAF)
- Bot 管理
- 压缩控制
创建 StyleBook 以迁移 NetScaler 应用程序配置
以下过程用于创建在 NetScaler Console 中迁移 NetScaler 应用程序的 StyleBook：
-
导航到“应用程序”>“配置”>“配置包”。
-
单击“迁移 NetScaler 配置”。
-
单击“开始”。
-
在“指定配置”中，选择配置源：
-
从 NetScaler 导入：此选项发现所选 NetScaler 实例上的活动应用程序。
-
使用 CLI 命令导入：此选项分析 CLI 命令并从 CLI 命令中提取应用程序。
-
-
指定要从中迁移或复制应用程序配置的“源 NetScaler 实例”。
要将应用程序配置迁移到 Autoscale 组，请确保源配置中不包含以下信息：
IPset- 设备配置文件
- 协议
- 端口
-
指定要迁移或复制应用程序配置到的“目标 NetScaler 实例”。
要将应用程序配置迁移到 Autoscale 组，请从列表中选择 Autoscale 组。
-
在“定义应用程序”中，
-
在“应用程序名称”中，指定应用程序的名称。
如果目标实例是 Autoscale 组，请指定以下 Autoscale 参数：
-
访问类型 - 您可以使用 NetScaler Console 自动扩缩解决方案来处理外部和内部应用程序。选择所需的应用程序访问类型。
-
域名 - 指定应用程序的域名。此选项仅当您选择“用户定义的 FQDN 类型”时适用。
-
域的区域 - 从列表中选择应用程序的区域名称。此选项仅当您选择“用户定义的 FQDN 类型”时适用。
此域和区域名称重定向到 Azure 中的虚拟服务器。例如，如果您在
app.example.com中托管应用程序，则app是域名，example.com是区域名称。
-
-
选择要迁移的虚拟服务器。
-
单击“下一步”。
-
-
在“等效 CLI 命令”中，查看命令，然后单击“下一步”。
这些命令特定于选定的应用程序配置。
注意：
您也可以根据需要添加或编辑配置。
-
在“部署属性”中，您可以查看和编辑虚拟服务器、服务和服务组的成员的 IP 地址和端口。
要编辑 IP 地址和端口，请在流程图中单击虚拟服务器、服务或服务组的成员上的编辑图标。
注意：
如果目标实例是 Autoscale 组，则禁用编辑前端 IP 地址。
此选项卡仅在以下情况下显示：
-
源实例和目标实例不同。
-
使用 CLI 命令导入配置。
-
-
在“配置属性”中，指定必要的详细信息，然后单击“下一步”。
此选项卡列出密钥（例如用于解密密码和证书的密钥）。
注意：
在开始迁移之前，缺少或不支持的配置将显示在以下任何选项卡中：
-
不支持的配置
-
不支持的全局配置
要成功迁移这些配置，您必须在目标实例上单独应用缺少或不支持的配置。然后，单击“下一步”。
-
-
在“迁移”中，单击“迁移”。
限制
-
源实例中提及的命名表达式和
responderhtmlpages未被识别。确保在迁移之前配置命名表达式和responderhtmlpages。 -
如果源具有
servicegroup和监视器绑定配置，如下所示：bind serviceGroup <Name> <Port> -monitorName <Monitor_Name> <!--NeedCopy-->显示以下错误：
CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }] <!--NeedCopy-->出现此错误是因为 NetScaler 以无效格式保存服务组和监视器之间的绑定。此问题已在 NetScaler 12.1.52.15 版本中修复。