使用 StyleBooks 配置构建器迁移 NetScaler 应用程序配置

Last published : Oct 06, 2026
StyleBooks 配置构建器用于将现有 NetScaler 配置迁移到 StyleBooks。此功能还可自动将应用程序配置从一个 NetScaler 实例迁移到另一个实例或自动扩缩组。
配置构建器提供了一个结构化的应用程序 StyleBook，可用于 NetScaler 配置的任何变体。此功能可帮助您在不深入了解 StyleBooks 语法和构造的情况下开始使用 StyleBooks。否则，创建 StyleBook 需要了解 StyleBooks 语法和构造。
配置构建器还会创建一个配置包，该配置包在新 NetScaler 实例上反映相同的 NetScaler 配置。通过此配置包，可以将一个 NetScaler 实例的初始 NetScaler 配置复制到另一个 NetScaler 实例。初始配置源可以是以下之一：
  • NetScaler 实例： 指定要复制的应用程序配置所在的实例。
    即使您未指定目标实例，配置构建器也会将 NetScaler 配置转换为 StyleBook 和配置包。您以后可以使用此配置包将 NetScaler 配置迁移到其他 NetScaler 实例。
    如果目标实例是 Autoscale™ 组，则配置包将显示在“网络 > 自动扩缩组”页面中。“配置”选项卡下。
  • 一组 CLI 命令： 从 ns.conf 或 Application config 粘贴配置。
配置构建器会识别源配置中嵌入的独立应用程序列表。当您选择感兴趣的应用程序配置时，配置构建器会提取所选应用程序的 CLI 命令集。这些 CLI 命令是从源配置中提取的。它还会识别可能需要您输入的部署和配置属性。
  • IP 地址/端口 - 您可以查看和编辑原始配置中虚拟服务器、服务、服务组成员的 IP 地址和端口。
  • 配置文件/密钥 - 这些属性可以是源配置中指定的密码或证书。
指定必要信息后，开始在目标 NetScaler 实例上迁移或复制应用程序配置。
StyleBooks 配置构建器工作流程
应用程序创建和迁移后，将使用 adc_nitro_application StyleBook 在 NetScaler Console 中创建一个配置包。此 StyleBook 是根据 NetScaler NITRO 资源创建的。此配置包表示目标 NetScaler 实例上的应用程序配置。要查看创建的配置包，请导航到“应用程序 > 配置 > 配置包”。
Related information
样式簿

在已迁移的配置之间共享配置实体

您可以使用配置迁移实用程序在迁移配置时重用配置实体。后续迁移会成功重用现有配置实体。以前，当迁移共享某些配置实体的两个配置时，配置迁移会因错误“资源已存在”而失败。此选项通过允许在配置实体用于多个配置的场景中重用它们来简化迁移工作流程。

支持的 NetScaler 功能

StyleBook 配置构建器可识别并支持源配置中的以下 NetScaler 功能：
  • 内容切换
  • 负载均衡
  • 监控
  • SSL 卸载
  • 速率限制
  • 重写
  • 响应程序
  • Web 应用程序防火墙 (WAF)
  • 机器人管理
  • 压缩控制

创建 StyleBook 以迁移 NetScaler 应用程序配置

以下过程用于创建 StyleBook，以在 NetScaler Console 中迁移 NetScaler 应用程序迁移：
  1. 导航到 应用程序 > 配置 > 配置包。
  2. 单击 迁移 NetScaler 配置。
  3. 单击 开始使用。
  4. 在 指定配置 中，选择配置源：
    • 从 NetScaler 导入：此选项发现所选 NetScaler 实例上的活动应用程序。
    • 使用 CLI 命令导入：此选项分析 CLI 命令并从 CLI 命令中提取应用程序。
  5. 指定要从中迁移或复制应用程序配置的 源 NetScaler 实例。
    要将应用程序配置迁移到自动扩缩组，请确保源配置中不包含以下信息：
    • IPset
    • 设备配置文件
    • 协议
    • 端口
  6. 指定要将应用程序配置迁移或复制到的 目标 NetScaler 实例。
    要将应用程序配置迁移到自动扩缩组，请从列表中选择自动扩缩组。
  7. 在 定义应用程序 中，
    1. 在“应用程序名称”中，指定应用程序的名称。
      如果目标实例是自动扩缩组，请指定以下自动扩缩参数：
      • 访问类型 - 您可以将 NetScaler Console 自动扩缩解决方案用于外部和内部应用程序。选择所需的应用程序访问类型。
      • 域名 - 指定应用程序的域名。此选项仅在您选择“用户定义的 FQDN”类型时适用。
      • 域的区域 - 从列表中选择应用程序的区域名称。此选项仅在您选择“用户定义的 FQDN”类型时适用。
        此域和区域名称将重定向到 Azure 中的虚拟服务器。例如，如果您在 app.example.com 中托管应用程序，则 app 是域名，example.com 是区域名称。
    2. 选择要迁移的虚拟服务器。
    3. 单击“下一步”。
  8. 在“等效 CLI 命令”中，查看命令，然后单击“下一步”。
    这些命令特定于所选的应用程序配置。
    注意：
    如果需要，您还可以添加或编辑配置。
  9. 在“部署属性”中，您可以查看和编辑虚拟服务器、服务和服务组成员的 IP 地址和端口。
    要编辑 IP 地址和端口，请单击流程图中的虚拟服务器、服务或服务组成员上的编辑图标。
    编辑部署属性
    注意：
    如果目标实例是自动扩缩组，则禁用编辑前端 IP 地址。
    此选项卡仅在以下情况下显示：
    • 源实例和目标实例不同。
    • 使用 CLI 命令导入配置。
  10. 在“配置属性”中，指定必要的详细信息，然后单击“下一步”。
    此选项卡列出了密钥等机密，用于解密密码和证书。
    注意：
    在开始迁移之前，缺失或不支持的配置会显示在以下任一选项卡中：
    • 不支持的配置
    • 不支持的全局配置
    要成功迁移这些配置，您必须在目标实例上单独应用缺失或不支持的配置。然后，单击“下一步”。
  11. 在“迁移”中，单击“迁移”。

限制

  • 源实例中提及的命名表达式和 responderhtmlpages 未被识别。请务必在迁移之前在目标实例上配置命名表达式和 responderhtmlpages。
  • 如果源具有 servicegroup 和监视器绑定的配置，如下所示：
    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>
    出现以下错误：
    CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
    出现此错误是因为 NetScaler 以无效格式保存了服务组和监视器之间的绑定。此问题已在 NetScaler 12.1.52.15 版本中修复。