本教程介绍如何使用弹性伸缩生命周期挂钩挂起ECS实例,并结合运维编排服务OOS的模板,实现扩缩容时在ECS实例中自动执行脚本。

前提条件

  • 使用本教程进行操作前,请确保您已经注册了阿里云账号。如还未注册,请先完成账号注册
  • 已创建伸缩组,且伸缩组处于启用状态。
  • 已准备好待执行的脚本,本教程中以为Linux实例(CentOS 7.6)自动安装Apache为例。
  • 已为OOS服务创建RAM角色,具体操作请参见为OOS服务设置RAM权限
    说明 本教程中使用默认的RAM角色OOSServiceRole,您也可以使用其他自定义的RAM角色,但需要保证RAM角色拥有执行OOS模板所需的权限。

操作步骤

本教程以OOS公共模板ACS-ESS-LifeCycleRunCommand为例,实现扩容时在ECS实例中自动执行脚本。步骤如下:

步骤一:对RAM角色授予OOS服务权限

您需要拥有OOS的执行权限才能执行OOS的模板。执行ACS-ESS-LifeCycleRunCommand中定义的运维操作时涉及云服务器ECS、弹性伸缩的资源。

  1. 登录RAM控制台
  2. 创建权限策略。
    1. 在左侧导航栏,单击权限管理 > 权限策略管理
    2. 在页面左上角,单击创建权限策略
    3. 新建自定义权限策略页面,指定权限配置,然后单击确定
      本教程中使用的配置如下表所示,未提及的配置保持默认即可。
      配置项 说明
      策略名称 填写ESSHookPolicyForRunCommand。
      配置模式 选择脚本配置
      策略内容 输入以下内容:
      {
          "Version": "1",
          "Statement": [
              {
                  "Action": [
                      "ecs:DescribeInvocationResults",
                      "ecs:DescribeInvocations",
                      "ecs:RunCommand"
                  ],
                  "Resource": "*",
                  "Effect": "Allow"
              },
              {
                  "Action": [
                      "ess:CompleteLifecycleAction"
                  ],
                  "Resource": "*",
                  "Effect": "Allow"
              }
          ]
      }
  3. 为OOSServiceRole授予权限策略。
    1. 在左侧导航栏,单击RAM角色管理
    2. 找到OOSServiceRole,在操作区域,单击添加权限
      为OOS服务扮演的RAM角色OOSServiceRole添加权限即可完成授权。
    3. 添加权限页面,指定权限配置,然后单击确定
      本教程中使用的配置如下表所示,未提及的配置保持默认即可。
      配置项 说明
      授权范围 选择云帐号全部资源
      选择权限 添加自定义策略ESSHookPolicyForRunCommand。

步骤二:为扩容活动创建生命周期挂钩并触发扩容

在创建生命周期挂钩时选择通知方式为OOS模板并设置相关参数,即可在触发扩容活动时自动执行脚本。

  1. 登录弹性伸缩控制台
  2. 在左侧导航栏中,单击伸缩组管理
  3. 在顶部菜单栏处,选择地域。
  4. 找到待操作的伸缩组,选择一种方式打开伸缩组详情页面。
    • 伸缩组名称/ID区域,单击伸缩组ID。
    • 操作区域,单击查看详情
  5. 为扩容活动创建生命周期挂钩。
    1. 在页面上方,单击生命周期挂钩页签。
    2. 单击创建生命周期挂钩
    3. 指定生命周期挂钩配置,然后单击确认
      本教程中使用的配置如下表所示,未提及的配置保持默认即可。
      配置项 说明
      名称 输入ESSHookForRunCommand。
      适用的伸缩活动类型 选择弹性扩张活动
      超时时间 输入适当的超时时间,例如300秒。
      说明 超时时间即用于执行自定义操作的时间,若超时时间过短,可能导致自定义操作失败,请评估自定义操作耗时并设置适当的超时时间。
      执行策略 选择继续
      通知方式 模板配置如下:
      • 通知方式:选择OOS模板
      • OOS模板类型:选择公共模板
      • 公共模板:选择ACS-ESS-LifeCycleRunCommand。
      ACS-ESS-LifeCycleRunCommand的执行参数配置如下:
      • 云助手命令类型:选择RunShellScript。
      • 云助手命令:输入待执行的脚本,本教程中以自动安装Apache为例。
        yum install -y httpd
        systemctl start httpd
        systemctl enable httpd
      • 执行使用到的权限的来源:选择OOSServiceRole,步骤一中已为RAM角色OOSServiceRole添加操作ECS、弹性伸缩资源的权限,OOS服务扮演该RAM角色即可拥有相关权限。
  6. 触发扩容。
    本教程中以手动执行伸缩规则为例,您也可以通过定时任务、报警任务等方式触发扩容。
    说明 手动执行伸缩规则触发扩缩容时,生命周期挂钩会生效,但手动添加或移出已有ECS实例时,生命周期挂钩不会生效。
    1. 在页面上方,单击伸缩规则页签。
    2. 单击创建伸缩规则
    3. 设置伸缩规则的属性,然后单击确认
      本教程中使用的配置如下表所示,未提及的配置保持默认即可。
      配置项 说明
      规则名称 输入Add1。
      伸缩规则类型 选择简单规则
      执行的操作 设置为增加1台。
    4. 伸缩规则页面,找到新建的伸缩规则Add1,在操作区域,单击执行
    5. 单击确定
    执行伸缩规则后自动创建1台ECS实例,由于伸缩组内已创建生命周期挂钩ESSHookForRunCommand,ECS实例会被挂起,同时自动通知OOS服务执行ACS-ESS-LifeCycleRunCommand中定义的运维操作。
  7. 查看自动创建的ECS实例是否符合预期。
    1. 在页面上方,单击实例列表页签。
    2. 找到自动创建的ECS实例,在云服务器ID/名称区域,单击实例ID。
    3. 在左侧导航栏中,单击本实例远程命令
    4. 在页面左上角,单击发送远程命令
    5. 执行以下命令查看Apache安装结果。
      systemctl status httpd
      如下图所示,显示Apache服务已安装且状态为active,符合使用公共模板ACS-ESS-LifeCycleRunCommand执行步骤二中示例脚本的预期。apache-status

      如果成功创建了ECS实例,但ECS实例并没有自动安装Apache,请前往OOS控制台查看运维任务执行情况,具体步骤请参见(可选)步骤三:查看OOS执行情况

(可选)步骤三:查看OOS执行情况

  1. 登录OOS管理控制台
  2. 在左侧导航栏,单击执行管理
  3. 按开始时间找到执行,然后在操作区域,单击详情
  4. 单击高级视图
    执行结果页签中显示执行状态。success
    如果执行失败,执行结果页签中也会显示相关的报错信息。failed

常见问题

如果运维任务执行失败,请根据执行结果中的报错信息排查原因。常见的报错信息及解决方案如下:
  • 报错信息:Forbidden.Unauthorized message: A required authorization for the specified action is not supplied.

    解决方案:请检查是否为RAM角色OOSServiceRole添加了相应的权限,例如步骤一中的示例权限。您需要为RAM角色添加操作权限,确保OOS服务能够操作OOS模版中涉及的资源。

  • 报错信息:Forbidden.RAM message: User not authorized to operate on the specified resource, or this API doesn't support RAM.

    解决方案:请检查是否为RAM角色OOSServiceRole添加了相应的权限,例如步骤一中的示例权限。您需要为RAM角色添加操作权限,确保OOS服务能够操作OOS模版中涉及的资源。

  • 报错信息:LifecycleHookIdAndLifecycleActionToken.Invalid message: The specified lifecycleActionToken and lifecycleActionId you provided does not match any in process lifecycle action.

    解决方案:请评估生命周期挂钩的超时时间,确保在超时时间内可以执行完OOS模板中定义的运维任务。

相关文档

如果您需要为已经加入伸缩组的ECS实例执行脚本,可以使用滚动升级功能,相关操作和教程请参见: