仅执行命令部署物

当没有应用源文件需要指定,应用发布完全通过脚本实现时,可以使用此种类型的部署物来发布应用。

工作原理

重要
  • 当发布的应用分组为ESS伸缩组时,部署期间伸缩活动会被暂停,部署结束后(无论成功或失败)将自动恢复。

  • 部署流程遵循先停后启原则,即每次部署都会先执行停止脚本,再执行启动脚本。

  1. 创建并发布部署物

    将应用源文件信息、启动脚本和停止脚本配置为部署物。

    创建发布任务,选择发布模式,将部署物发布至目标应用分组。

  2. 发布任务的自动化部署流程

    1. 获取部署物信息,包括应用的启动/停止脚本。

    2. 执行停止脚本:执行应用停止脚本,停止旧版本应用。

    3. 执行启动脚本:执行应用启动脚本,启动新版本应用。

适用范围

  • 仅支持部署到Linux实例。

  • 启动和停止脚本仅支持Shell类型的脚本。

操作步骤

  1. 准备应用、分组和ECS实例。

    在开始部署前,需要先在ECS应用管理中创建应用和分组,并将准备好的ECS实例加入到分组。

    1. 如果没有ECS实例,前往ECS控制台-自定义购买页面,创建Linux操作系统的ECS实例。

      建议ECS镜像选择Alibaba Cloud Linux 3.2104 LTS 64位或Ubuntu 22.04 64位。后续示例中的脚本基于这两种镜像编写。如果使用其他镜像,请参考示例并根据实际情况修改脚本。
    2. 前往ECS控制台-应用管理页面,单击导入已有资源创建,创建应用和应用分组,并导入ECS实例到应用分组。

    3. 为分组内的ECS实例安装Docker。在应用分组的运维管理页签下,选择安装/卸载扩展程序来批量安装Docker。

      如果ECS实例是基于自定义镜像创建的,无法通过此方式安装扩展程序。需要远程连接到实例并手动安装Docker
  2. 创建部署物。

    1. 拉取示例镜像到本地,然后推送镜像到个人版ACR实例仓库。

      docker pull aliyun-computenest-opensource-registry.cn-hangzhou.cr.aliyuncs.com/default/aliyun-code-deploy:latest
    2. 前往ECS控制台-应用管理页面,在我的应用页签下,单击目标应用名称。

    3. 在应用详情页,选择参数页签,单击创建参数。创建usernamepassword两个参数,分别对应个人版ACR的用户名和密码。为保障安全,将password参数创建为加密参数。

    4. 在应用详情页,选择部署物页签,然后单击创建部署物

    5. 创建部署物页面,部署物类型选择仅执行命令,设置参数后单击确定保存。

      • 工作目录:设置应用启动/停止脚本的执行目录。示例:/root/deploy

      • 应用启动脚本:将<repo><image>的值替换为个人版ACR信息。

        下图中第一个字段为repo,第二个字段为image。将这两个字段的值替换至应用启动脚本中对应的参数位置。image
        ### 启动当前版本的应用
        ### Start the current version of the application            
        function start_application() {
           repo="<repo>"
           image="<image>"
           container_name="my-container"
           docker login --username=${username} --password=${password} $repo
           docker pull $image
           docker run -d -p 8080:8080 --name $container_name $image
        }
        
        start_application
      • 应用停止脚本

        ### 停止容器(如果有)
        ### Stop the container (if any)
        
        function stop_application() {
          # 通过容器名查询容器是否存在,如存在则删除容器
          # Query whether the container exists by the container name, and delete the container if it exists
          container_name="my-container"
          container_id=$(docker ps -aq -f name=${container_name}) 
          if [ -n "$container_id" ]; then
            docker rm -f $container_id
          fi
        }
        
        stop_application
  3. 返回部署物列表,找到刚创建的部署物,单击发布。选择目标分组,单击确定开始部署。

  4. 结果验证。

    1. 进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。根据页面提示登录,进入终端页面。

    2. 执行curl http://localhost:8080/hello命令。返回Alibaba Spring Sample!表示部署成功。

重要字段

字段

说明

工作目录

应用的启动/停止脚本的工作目录。

  • 需填写绝对路径。

  • 可填写不存在的目录,执行期间会自动创建。

应用启动脚本

用于启动应用的Shell脚本。

应用停止脚本

用于停止应用的Shell脚本。
脚本需要能够正确停止当前及历史版本的应用。当没有应用在运行时,脚本也应能正常退出且不报错。

例如,以下脚本可停止名为my-container的容器(假设每个版本的容器名都叫做my-container),且在容器不存在时不会报错:

container_name="my-container"
container_id=$(docker ps -aq -f name=${container_name}) 
if [ -n "$container_id" ]; then
  docker rm -f $container_id
fi