使用阿里云CLI执行滚动升级任务

操作步骤

步骤一：创建RAM用户并添加权限

1. 登录RAM控制台。
2. 创建RAM用户。
   本步骤中以创建名为clitest的RAM用户为例。更多信息，请参见创建RAM用户。
   1. 在左侧导航栏，选择身份管理 > 用户。
   2. 单击创建用户。
   3. 在创建用户页面，指定用户配置，然后单击确定。
      示例配置如下表所示。

      配置项	示例配置
      登录名称	example@sample.com
      显示名称	example
      访问方式	选中OpenAPI 调用访问。 自动为RAM用户生成访问密钥（AccessKey），支持通过API或其他开发工具访问阿里云。

   4. 在用户信息页面，单击下载CSV文件。
      说明 AccessKeySecret只在创建时显示，不提供查询，请妥善保管。如果AccessKey泄露或丢失，则需要创建新的AccessKey。
3. 为RAM用户添加操作资源的权限。
   1. 在左侧导航栏，选择身份管理 > 用户。
   2. 找到已创建的RAM用户clitest，在操作列，单击添加权限。
   3. 在添加权限页面，选择执行滚动升级任务所需的权限，然后单击确定。
      示例配置如下表所示。

      配置项	示例配置
      授权范围	保持默认整个云账号。
      被授权主体	保持默认example@sample.com。
      选择权限	选择以下系统权限： AliyunECSFullAccess：操作ECS资源的权限，包括ECS实例等资源。 AliyunESSFullAccess：操作弹性伸缩资源的权限，包括伸缩组等资源。 AliyunOOSFullAccess：操作运维编排资源的权限，包括执行等资源。 AliyunOSSFullAccess：操作对象存储资源的权限，包括bucket等资源。

步骤二：配置并验证阿里云CLI

更多配置项的说明，请参见阿里云CLI文档中的配置阿里云CLI部分。

1. 在您的本地电脑中打开命令行工具。
2. 配置阿里云CLI。
   1. 运行以下命令打开配置文件。

      aliyun configure

   2. 按提示输入AccessKeyID、AccessKeySecret等信息。
      
3. 运行以下命令验证阿里云CLI是否可用。

   aliyun ecs DescribeRegions

   该命令用于查询支持的地域信息，返回地域信息表示命令执行成功，示例如下图所示。

步骤三：通过阿里云CLI执行滚动升级任务

本步骤提供示例命令，演示更新伸缩组内ECS实例的镜像、在ECS实例中执行脚本以及为ECS实例安装OOS软件包。

1. 输入阿里云CLI命令执行滚动升级任务。
   示例代码中涉及的OOS模板参数说明，请参见模板参数说明。
   • 镜像更新示例命令如下，实现将伸缩组内ECS实例的镜像更新为Alibaba Cloud Linux 2.1903 LTS 64位。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByReplaceSystemDiskInScalingGroup --Parameters "{
             \"invokeType\": \"invoke\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"scalingConfigurationId\": \"asc-bp1bx8mzur534edp****\",
             \"imageId\": \"aliyun_2_1903_x64_20G_alibase_20200529.vhd\",
             \"sourceImageId\": \"centos_7_8_x64_20G_alibase_20200717.vhd\",
             \"OOSAssumeRole\": \"\",
             \"enterProcess\": [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"exitProcess\":  [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

   • 脚本执行示例命令如下，实现在伸缩组内ECS实例中执行Shell命令df -h和ifconfig查看实例的磁盘和网络配置信息。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByRunCommandInScalingGroup --Parameters "{
             \"invokeType\": \"invoke\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"commandType\": \"RunShellScript\",
             \"invokeScript\": \"df -h\nifconfig\",
             \"rollbackScript\": \"df -h\nifconfig\",
             \"OOSAssumeRole\": \"\",
             \"exitProcess\": [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"enterProcess\": [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

   • 安装OOS软件包示例命令如下，实现为伸缩组内的ECS实例统一安装OOS中已创建的WordPress软件包。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByConfigureOOSPackage --Parameters "{
             \"invokeType\": \"invoke\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"packageName\": \"wordpress\",
             \"packageVersion\": \"v4\",
             \"action\": \"install\",
             \"OOSAssumeRole\": \"\",
             \"enterProcess\": [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"exitProcess\": [
               \"ScaleIn\",
               \"ScaleOut\",
               \"HealthCheck\",
               \"AlarmNotification\",
               \"ScheduledAction\"
             ],
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

2. 查看执行详情。
   执行滚动升级任务的CLI命令时，会自动在OOS中创建执行。您可以通过返回的执行ID查看执行的详情，包括执行结果、输出等信息。下面以查看脚本执行的输出为例，介绍如何获取执行ID并查看执行详情。
   1. 在命令的返回信息中找到滚动升级任务的执行ID。
      执行ID示例如下图所示。
   2. 运行以下阿里云CLI命令查看执行详情。

      aliyun oos ListExecutions --ExecutionId exec-40e2e17ef7e04****

      执行详情示例如下图所示。

执行回滚任务：滚动升级异常时的处理

如果滚动升级过程中出现异常，或者滚动升级后又需要使用历史配置，您可以执行回滚任务为伸缩组内ECS实例恢复配置。本步骤提供示例命令，演示如何回滚已经执行的滚动升级任务。

1. 在命令的返回信息中找到滚动升级任务的执行ID。
   执行ID示例如下图所示。
2. 输入阿里云CLI命令执行回滚任务。
   示例代码中涉及的OOS模板参数说明，请参见模板参数说明。
   说明 执行回滚任务时，OOS会根据滚动升级任务自动进行过滤待回滚的ECS实例、暂停和恢复伸缩组流程等操作，因此您可以跳过指定部分参数。
   • 回滚镜像更新示例命令如下，实现将ECS实例的镜像回滚为CentOS 7.8 64位。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByReplaceSystemDiskInScalingGroup --Parameters "{
             \"invokeType\": \"rollback\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"scalingConfigurationId\": \"asc-bp1bx8mzur534edp****\",
             \"sourceImageId\": \"centos_7_8_x64_20G_alibase_20200717.vhd\",
             \"sourceExecutionId\": \"exec-83dba59be77d430****\",
             \"OOSAssumeRole\": \"\",
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

   • 回滚脚本执行示例命令如下，实现在ECS实例中执行回滚用的脚本。此处仍然以Shell命令df -h和ifconfig为例，您可以按需要更换脚本。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByRunCommandInScalingGroup --Parameters "{
             \"invokeType\": \"rollback\",
             \"commandType\": \"RunShellScript\",
             \"rollbackScript\": \"df -h\nifconfig\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"sourceExecutionId\": \"exec-40e2e17ef7e046****\",
             \"OOSAssumeRole\": \"\",
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

   • 回滚安装OOS软件包示例命令如下，实现为ECS实例统一安装OOS中已创建的WordPress软件包历史版本。

     aliyun oos StartExecution --TemplateName ACS-ESS-RollingUpdateByConfigureOOSPackage --Parameters "{
             \"invokeType\": \"rollback\",
             \"scalingGroupId\": \"asg-bp18p2yfxow2dloq****\",
             \"packageVersion\": \"v3\",
             \"packageName\": \"wordpress\",
             \"sourceExecutionId\": \"exec-f4e61f2f21fe490****\",
             \"OOSAssumeRole\": \"\",
             \"batchNumber\": 2,
             \"batchPauseOption\": \"Automatic\"
           }"

3. 查看执行详情。
   执行回滚任务的CLI命令时，同样会自动在OOS中创建执行。您同样可以通过步骤三中的方法查看执行的详情，包括执行结果、输出等信息。

模板参数说明