slergberg/aws-deploy

aws-deploy Docker镜像文档

镜像概述

aws-deploy是一个专为简化AWS云服务部署流程设计的Docker镜像。该镜像集成了AWS CLI（命令行工具）及相关部署工具，旨在帮助开发和运维团队快速、自动化地将应用程序、配置及资源部署到AWS云平台，减少手动操作并提高部署一致性。

核心功能与特性

核心功能

• 集成AWS CLI：内置AWS Command Line Interface，支持直接执行AWS命令操作云资源
• 多服务支持：兼容EC2、S3、Lambda、ECS、EKS、DynamoDB等主流AWS服务部署
• 部署流程自动化：支持自定义部署脚本，实现从构建到部署的全流程自动化
• 环境隔离：通过环境变量配置实现多环境（开发/测试/生产）部署隔离

主要特性

• 轻量级：基于Alpine或Debian slim基础镜像，体积小巧
• 灵活配置：支持通过环境变量、挂载配置文件等方式自定义AWS认证及部署参数
• 版本兼容：内置AWS CLI最新稳定版本，确保与AWS服务API兼容性
• 安全可靠：支持IAM角色认证，避免硬编码凭证，符合AWS安全最佳实践

使用场景

1. 开发环境快速部署：开发人员无需本地安装AWS CLI，通过容器快速部署测试版本到AWS开发环境
2. CI/CD流水线集成：作为CI/CD流程（如Jenkins、GitLab CI、GitHub Actions）的部署步骤，实现代码提交后自动部署
3. 多环境一致性部署：通过统一镜像确保开发、测试、生产环境部署流程一致，减少"在我机器上能运行"问题
4. 批量资源部署：用于批量创建或更新AWS资源（如S3桶配置、Lambda函数、EC2实例标签等）

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 拥有AWS账号及具备部署权限的IAM用户/角色凭证（Access Key ID和Secret Access Key，或IAM角色ARN）

基本使用（docker run）

1. 基础AWS CLI操作

通过容器执行AWS CLI命令，验证AWS连接：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  aws-deploy \
  aws s3 ls

2. 部署应用到S3

挂载本地应用目录并执行部署脚本：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -v $(pwd)/app:/app \
  aws-deploy \
  sh -c "aws s3 sync /app s3://your-bucket-name --delete"

3. 部署Lambda函数

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \
  -e AWS_REGION="us-east-1" \
  -v $(pwd)/lambda-function:/function \
  aws-deploy \
  sh -c "cd /function && zip -r function.zip . && aws lambda update-function-code --function-name my-function --zip-file fileb://function.zip"

docker-compose配置示例

创建docker-compose.yml文件，集成到项目部署流程：

yaml
version: '3.8'
services:
  aws-deploy:
    image: aws-deploy
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_REGION=us-east-1
      - DEPLOY_ENV=production
    volumes:
      - ./deploy-scripts:/scripts
      - ./app-build:/app
    command: sh /scripts/deploy-production.sh

执行部署：

bash
# 加载环境变量（推荐使用.env文件）
export AWS_ACCESS_KEY_ID="your-key"
export AWS_SECRET_ACCESS_KEY="your-secret"

# 执行部署
docker-compose up

环境变量配置

IAM角色认证（推荐用于ECS/EKS环境）

若在AWS ECS或EKS中运行该镜像，可通过IAM角色实现免密钥认证：

1. 创建具备部署权限的IAM角色，并附加至ECS任务执行角色/EKS服务账户
2. 运行容器时无需挂载Access Key，直接通过IAM角色获取临时凭证：

bash
docker run --rm \
  -e AWS_REGION="us-east-1" \
  aws-deploy \
  aws s3 ls  # 自动使用ECS/EKS任务关联的IAM角色权限

部署脚本示例

以下是一个部署Node.js应用到EC2实例的示例脚本（保存为deploy-ec2.sh，挂载到/scripts目录）：

bash
#!/bin/sh
set -e

# 1. 打包应用
cd /app
npm ci --only=production
zip -r app-deploy.zip .

# 2. 上传到EC2实例（需提前配置EC2实例SSH密钥）
scp -i /scripts/ec2-key.pem app-deploy.zip ec2-user@${EC2_INSTANCE_IP}:/home/ec2-user/

# 3. 远程执行部署命令
ssh -i /scripts/ec2-key.pem ec2-user@${EC2_INSTANCE_IP} << 'EOF'
  cd /home/ec2-user
  unzip -o app-deploy.zip -d app/
  cd app
  pm2 restart app.js  # 假设使用pm2管理Node.js进程
EOF

echo "部署完成：${DEPLOY_ENV}环境（EC2实例：${EC2_INSTANCE_IP}）"

执行该脚本：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret" \
  -e AWS_REGION="us-east-1" \
  -e DEPLOY_ENV="production" \
  -e EC2_INSTANCE_IP="192.168.1.100" \
  -v $(pwd)/deploy-scripts:/scripts \
  -v $(pwd)/node-app:/app \  
  aws-deploy \
  sh /scripts/deploy-ec2.sh

注意事项

1. 凭证安全：避免在镜像中硬编码AWS凭证，优先使用环境变量或IAM角色
2. 权限最小化：为IAM用户/角色分配最小必要权限（遵循AWS最小权限原则）
3. 镜像更新：定期更新镜像以获取AWS CLI及依赖的安全补丁（docker pull aws-deploy:latest）
4. 日志记录：部署过程建议输出详细日志，便于问题排查（可重定向至文件或日志服务）