track0x1/aws-ecs-resource

AWS ECS Resource镜像

AWS ECS Resource镜像是Concourse CI的资源类型，用于在AWS ECS集群上执行滚动部署，帮助开发者自动化ECS服务的更新流程。

镜像概述

本镜像作为Concourse CI的扩展资源，实现了与AWS ECS的集成，支持从任务定义检索到服务部署的全流程操作，适用于CI/CD流水线中的ECS服务发布场景。

核心功能

1. 任务定义检索：获取指定ECS服务的任务定义并保存至历史记录，供后续部署使用。
2. 滚动部署：基于新镜像标签创建或复用任务定义，更新ECS服务实现滚动发布。
3. 缓存复用：支持缓存已生成的任务定义，加速后续部署流程，避免重复创建。

使用场景

1. 金丝雀发布：在Concourse流水线中先部署至测试/金丝雀环境验证，再推广至生产环境。
2. 生产环境更新：自动化生产环境ECS服务的滚动更新，确保服务无中断。
3. 多环境部署：适配测试、预发、生产等多环境的ECS服务部署需求。

配置说明

源配置（Source Configuration）

• cluster_name：必填，ECS集群名称。
• image_name：必填，ECS服务使用的基础镜像名称（不含标签）。
• region：必填，部署的AWS区域。

参数（Parameters）

• cache：可选，已执行get操作的AWS资源路径（用于复用任务定义）。
• service_name：必填，需更新的ECS服务名称。
• tag：可选，包含镜像标签的文件路径（通常来自Git资源的.git/ref）。

部署示例

以下是Concourse CI流水线中使用该镜像的配置示例：

yaml
resource_types:
  - name: aws-resource
    type: docker-image
    source:
      repository: track0x1/aws-ecs-resource

resources:
  - name: app-code
    type: git
    # Git资源配置（此处省略）
  - name: aws
    type: aws-resource
    source:
      cluster_name: app-code-cluster
      image_name: registry.hub.docker.com/my-app-code
      region: us-east-1

jobs:
  - name: canary
    plan:
      - get: app-code
      - put: aws
        params:
          service_name: app-code-canary
          tag: app-code/.git/ref
  - name: prod
    plan:
      - get: aws
        passed: [canary]
      - put: aws
        params:
          cache: aws
          service_name: app-code-prod

行为说明

• check：无操作（No-op）。
• in：检索任务定义并保存至./history文件，供后续put操作使用。
• out：创建或复用任务定义，更新指定ECS服务的镜像标签并执行滚动部署。