完成升级

执行 Automation Suite 集群升级后，需要做出一些更改，以确保新节点通过横向扩展操作正确加入集群。要自动执行更改，我们建议使用 upgrade_wrapper.py 脚本。

准备

先决条件

确保满足以下要求：

• 必须在执行脚本的计算机上安装 Python 3.8 或更高版本。有关详细信息，请参阅 Python 文档。
• 脚本需要 Python 包。您可以使用以下 pip 命令安装这些包。有关详细信息，请参阅 pip 文档。

  pip install wget requests boto3

• boto3 客户端必须能够通过 AWS 进行身份验证，因为部署更改通过该方式发生。您可以提供凭据作为环境变量，也可以使用共享凭据文件通过默认配置文件提供。用户必须有权执行“脚本行为”部分中所述的操作。

• 确保自动调整组（服务器、代理等）的 RHEL 版本已更新，并且与要升级到的版本相符。

• 请务必查看 cluster_config.json 文件，并将标记为字符串 ("true"/"false") 的所有布尔值更改为实际的布尔值 (true/false)。例如：
  • 要启用区域恢复，请使用 "zone_resilience": true。
  • 要允许安装程序创建数据库，请使用 "sql.create_db": true。
• 如果从 Automation Suite 2022.10 升级到 Automation Suite 2023.4 或更高版本，并且新旧版本中都启用了 Orchestrator，则必须在 cluster_config.json 文件中将 orchestrator.block_classic_executions 标志设置为 true。使用该标志即表示您同意阻止传统文件夹执行。不使用该标志会导致升级操作失败。新安装中不需要此参数。
• 如果您升级到 Automation Suite 2023.10 或更高版本，并且在新旧环境中都启用了 Insights，则必须将 insights.external_object_storage.bucket_name 标志设置为 cluster_config.json 文件中 platform 使用的相同存储桶。不使用该标志会导致升级操作失败。新安装中不需要此参数。
• 如果您升级到 Automation Suite 2023.10 或更高版本，请确保在将 sql.create_db 设置为 true 时，在 cluster_config.json 中填写以下字段：

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

脚本注意事项

运行 upgrade_wrapper.py 脚本时，请注意该脚本执行的以下操作：

• 在当前文件夹中下载所需的依赖项；
• 从 Automation Suite 部署堆栈中提取信息；

• 创建一个新堆栈，其中包含：

  • 初始部署中存在的每个自动调整组的新启动模板，其中包含新版本安装流程所需的更改；
  • Automation Suite 节点使用的已附加到 IAM 角色的 IAM 策略，允许对当前堆栈执行 DescribeStackResource 操作；
    注意：仅当部署时未提供自定义 IAM 角色时，才会部署该策略。否则，您应将新部署堆栈的 cloudformation:DescribeStackResource 权限授予 Automation Suite 节点使用的 IAM 角色。
• 更新自动调整组以使用在新堆栈中创建的启动模板；
• 更新包含安装程序 URL 的 SSM 参数（可选，具体取决于初始部署模板版本）；

• 通过 SSM 运行命令在所有节点上使用用于升级的安装程序覆盖初始部署中使用的旧安装程序。这是为了保留初始部署中已存在的 SSM 文档的功能；

  注意：更新启动模板后，AMI 更新 SSM 文档可能不再有效。应使用新创建的启动模板的 ec2:CreateLaunchTemplateVersion 权限和 ec2:RunInstances 权限更新 SSM 文档所使用的 IAM 角色。
• 清理下载的文件。

执行

要成功完成升级，请执行以下步骤：

1. 从此处下载 upgrade_wrapper.py 脚本。
2. 以交互或非交互模式运行脚本：
   • 选项 1：如果以交互模式运行脚本，请使用以下命令：python3 upgrade_wrapper.py

   • 选项 2：如果以非交互模式运行脚本，则系统会自动填充以下环境变量：

     • 使用您用于升级的 Automation Suite 版本填充 AS_VERSION 变量；
     • 特定版本所需的大写格式参数名称。您可以查看 upgrade_matrix.json 对象中定义此流程所需依赖项的参数。例如，要传递 2022.10.1 版本所需的部署区域，您必须设置 AS_DEPLOYMENT_REGION 环境变量。