mobeatsglobal/aws-cli-dind

aws-cli-dind

基于Alpine构建的轻量级多架构Docker镜像，整合AWS CLI v2与Docker CLI，旨在为CI/CD流水线提供高效、低开销的环境，无需在AWS CLI镜像内额外安装Docker。

核心功能

• 包含完整依赖的AWS CLI v2（内置Python运行时，功能完整）
• 集成最新稳定版Docker CLI（无需Docker守护进程即可执行容器管理命令）
• 基于最小化Alpine系统，兼容性强且体积小巧（约250MB）
• 支持amd64和arm64双架构
• 适用于GitLab CI、GitHub Actions等需与AWS服务（ECR、ECS）及Docker registry交互的流水线场景

使用场景

• CI/CD流水线中构建并推送镜像到AWS ECR
• 自动化部署应用到AWS ECS集群
• 需要同时使用AWS CLI和Docker CLI的开发/测试自动化工作流

配置说明

基础使用

bash
docker run --rm docker.xuanyuan.run/mobeatsglobal/aws-cli-dind:latest aws --version
docker run --rm docker.xuanyuan.run/mobeatsglobal/aws-cli-dind:latest docker --version

GitLab CI示例

以下是使用该镜像构建并推送至AWS ECR、部署到ECS的GitLab CI任务示例（需预先配置相关变量）：

预定义变量
需在GitLab项目/组/服务器级别配置以下变量：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥
• AWS_REGION：AWS区域
• DOCKER_REGISTRY：AWS ECR registry地址（格式：账户ID.dkr.ecr.区域.amazonaws.com）
• PROJECT：项目名称
• APP_NAME：应用名称
• ECS_CLUSTER：ECS集群名称
• ECS_SERVICE：ECS服务名称

CI配置文件

yaml
variables:
    AWS_DEFAULT_REGION: us-east-1
    DOCKER_HOST: tcp://docker:2375
    DOCKER_DRIVER: overlay2
    DOCKER_TLS_CERTDIR: ""

stages:
  - build
  - deploy

workflow:
  rules:
    - if: '$CI_COMMIT_TAG'

build:
  stage: build
  image:
    name: mobeatsglobal/aws-cli-dind
    entrypoint: [""]
  tags:
    - arm64 # 根据Runner架构选择（支持amd64/arm64）
  services:
    - name: docker:dind
      alias: docker
  before_script:
    - printf "\033[0Ksection_start:%s:set_up_tools\r\033[0K\033[36m设置工具\033[0m\n" "$(date +%s)"
    - docker --version
    - aws --version
    - until docker info; do echo "等待Docker守护进程启动..."; sleep 1; done
    - printf "\033[0Ksection_end:%s:set_up_tools\r\033[0K\n" "$(date +%s)"

  script:
    - printf "\033[0Ksection_start:%s:docker_login\r\033[0K\033[36mDocker登录\033[0m\n" "$(date +%s)"
    - aws ecr get-login-password | docker login --username AWS --password-stdin "$DOCKER_REGISTRY"
    - DOCKER_REGISTRY_IMAGE="$DOCKER_REGISTRY/$PROJECT/$APP_NAME"
    - printf "\033[0Ksection_end:%s:docker_login\r\033[0K\n" "$(date +%s)"

    - printf "\033[0Ksection_start:%s:build_image\r\033[0K\033[36m构建镜像\033[0m\n" "$(date +%s)"
    - docker build -t "$DOCKER_REGISTRY_IMAGE:latest" -f Dockerfile .
    - docker tag "$DOCKER_REGISTRY_IMAGE:latest" "$DOCKER_REGISTRY_IMAGE:$CI_COMMIT_TAG"
    - printf "\033[0Ksection_end:%s:build_image\r\033[0K\n" "$(date +%s)"
    
    - printf "\033[0Ksection_start:%s:pushing_image\r\033[0K\033[36m推送镜像\033[0m\n" "$(date +%s)"
    - docker push "$DOCKER_REGISTRY_IMAGE:latest"
    - docker push "$DOCKER_REGISTRY_IMAGE:$CI_COMMIT_TAG"
    - printf "\033[0Ksection_end:%s:pushing_image\r\033[0K\n" "$(date +%s)"

deploy:
  stage: deploy
  image:
    name: mobeatsglobal/aws-cli-dind
    entrypoint: [""]
  tags:
    - arm64 # 仅执行AWS命令，架构无强制要求
  script:
    - printf "\033[0;32m✅ 部署到ECS服务\033[0m\n"
    - currentTaskDefinition=$(aws ecs describe-services --region $AWS_REGION --cluster $ECS_CLUSTER --services $ECS_SERVICE --query 'services[0].taskDefinition' | tr -d '"')
    - aws ecs update-service --region $AWS_REGION --cluster $ECS_CLUSTER --service $ECS_SERVICE --task-definition $currentTaskDefinition --force-new-deployment