完成升级

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

准备

先决条件

确保满足以下要求：

• 必须在执行脚本的计算机上安装 Python 3.8 或更高版本。有关详细信息，请参阅Python 文档。

• 脚本需要 Python 包。您可以使用以下 pip 命令安装这些包。有关详细信息，请参阅pip 文档。

  pip install wget requests boto3
  

• boto3 clients must be able to authenticate to AWS because deployment changes occur through them. You can provide credentials as environment variables or through a default profile using a shared credential file. The user must have the permission to perform the actions described in the Script behavior section.

• 请务必查看 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。使用该标志即表示您同意阻止传统文件夹执行。不使用该标志会导致升级操作失败。新安装中不需要此参数。

脚本注意事项

运行 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环境变量。