appmerci/deploy-beanstalk

AWS Elastic Beanstalk部署工具镜像

镜像概述

本镜像为AWS Elastic Beanstalk（EBS）应用部署提供辅助工具集，包含环境变量验证、S3文件管理及EB环境更新等命令，旨在简化AWS EBS的部署流程，提升部署效率。

核心功能

1. 环境变量检查：通过checkenv命令验证指定环境变量是否已设置，确保部署前环境配置正确。
2. S3文件操作：
   • fileexistsons3：检查S3存储桶中指定文件是否存在（不存在时返回退出码4）。
   • uploads3：将本地文件上传至S3指定路径。
3. EB环境更新：通过updateeb命令使用S3中的版本包更新EB应用环境，并支持状态检查与超时配置。

使用场景

• CI/CD流水线中自动化部署AWS EBS应用。
• 手动快速更新EB应用环境。
• 验证部署前的环境配置及S3资源状态。

配置说明

必要环境变量

• AWS_REGION：AWS区域（如cn-north-1）。
• AWS_ACCESS_KEY：AWS访问密钥。
• AWS_SECRET_KEY：AWS秘密密钥。

可选环境变量（默认值）

• MAX_RETRIES=20：最大重试次数。
• MIN_RETRY_DELAY=1s：最小重试间隔。
• MAX_RETRY_DELAY=1m：最大重试间隔。
• AWS_CHECK_STATUS_INTERVAL=5s：EB状态检查间隔。
• AWS_CHECK_STATUS_TIMEOUT=15m：EB状态检查超时时间。
• AWS_READY_STATUS_WAIT=15s：EB就绪状态等待时间。
• AWS_DEGRADED_STATUS_TIMEOUT=15m：EB降级状态超时时间。

部署示例

构建镜像

bash
docker build -t plugins/aws .

运行容器执行命令

检查环境变量

bash
docker run -e AWS_REGION=cn-north-1 -e AWS_ACCESS_KEY=your_key -e AWS_SECRET_KEY=your_secret docker.xuanyuan.run/appmerci/deploy-beanstalk checkenv -application=your_app -environment=your_env -envs="ENV ENV2 ENV3"

检查S3文件存在性

bash
docker run -e AWS_REGION=cn-north-1 -e AWS_ACCESS_KEY=your_key -e AWS_SECRET_KEY=your_secret docker.xuanyuan.run/appmerci/deploy-beanstalk fileexistsons3 bucket:path/file.zip
echo $? # 不存在时返回4

上传文件到S3

bash
docker run -v $(pwd):/data -e AWS_REGION=cn-north-1 -e AWS_ACCESS_KEY=your_key -e AWS_SECRET_KEY=your_secret docker.xuanyuan.run/appmerci/deploy-beanstalk uploads3 /data/file.zip bucket:path/file.zip

更新EB环境

bash
docker run -e AWS_REGION=cn-north-1 -e AWS_ACCESS_KEY=your_key -e AWS_SECRET_KEY=your_secret -e AWS_CHECK_STATUS_INTERVAL=5s docker.xuanyuan.run/appmerci/deploy-beanstalk updateeb -application=your_app -environment=your_env -version=unique-hash -src=bucket:path