enouvoci/aws-cli-docker

AWS CLI Docker容器

镜像概述和主要用途

该Docker镜像包含预安装的AWS CLI工具，基于Alpine Linux构建，镜像大小仅87MB，轻量高效。适用于需要在容器环境中运行AWS CLI命令的场景，无需在主机系统直接安装AWS CLI，实现环境隔离和便捷部署。Docker Hub上提供自动化构建：https://hub.docker.com/r/garland/aws-cli-docker/

支持的标签及对应Dockerfile链接

• https://github.com/sekka1/aws-cli-docker/blob/0.1/0.1/Dockerfile
• https://github.com/sekka1/aws-cli-docker/blob/0.2/0.2/Dockerfile

AWS CLI版本

• 1.11.131

构建镜像

bash
docker build -t garland/aws-cli-docker:x.x .

核心功能和特性

• 轻量级：基于Alpine Linux，镜像大小仅87MB
• 完整AWS CLI：预安装AWS CLI 1.11.131，支持所有AWS CLI命令
• 灵活配置：通过环境变量传递AWS访问密钥和区域信息
• 文件挂载支持：可挂载本地文件（如AWS私钥）到容器中使用

使用场景和适用范围

• CI/CD流程中集成AWS操作（如S3上传、EC2实例管理）
• 临时执行AWS CLI命令，避免在主机安装依赖
• 多环境隔离的AWS资源管理
• 需要快速部署AWS CLI环境的场景

使用方法和配置说明

获取AWS访问密钥

参考AWS官方文档：AWS CLI设置指南 - 获取访问密钥

通过环境变量传递AWS凭据

可通过以下环境变量配置AWS CLI：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS密钥
• AWS_DEFAULT_REGION：默认AWS区域（可选）

参考文档：AWS CLI环境变量配置

命令行选项

AWS CLI支持的命令行选项（如指定区域、输出格式等），参考文档：AWS CLI命令行选项

使用示例

1. 描述EC2实例

bash
docker run \
--env AWS_ACCESS_KEY_ID=<<您的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<您的密钥>> \
--env AWS_DEFAULT_REGION=us-east-1 \
garland/aws-cli-docker \
aws ec2 describe-instances --instance-ids i-90949d7a

输出示例：

json
{
    "Reservations": [
        {
            "OwnerId": "960288280607",
            "ReservationId": "r-1bb15137",
            "Groups": [],
            "RequesterId": "226008221399",
            "Instances": [
                {
                    "Monitoring": {
                        "State": "enabled"
                    },
                    "PublicDnsName": null,
    ...
    ]
}

2. 列出S3存储桶内容

bash
docker run \
--env AWS_ACCESS_KEY_ID=<<您的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<您的密钥>> \
garland/aws-cli-docker \
aws s3 ls

输出示例：

2014-06-03 19:41:30 folder1
2014-06-06 23:02:29 folder2

3. 上传本地目录到S3存储桶

将当前目录（包含test.txt和test2.txt）同步到S3存储桶：

bash
docker run \
--env AWS_ACCESS_KEY_ID=<<您的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<您的密钥>> \
-v $PWD:/data \
garland/aws-cli-docker \
aws s3 sync . s3://mybucket

输出示例：

(dryrun) upload: test.txt to s3://mybucket/test.txt
(dryrun) upload: test2.txt to s3://mybucket/test2.txt

参考文档：AWS CLI S3命令

4. 通过私钥获取Windows实例密码

挂载本地私钥文件到容器，获取EC2实例的解密密码：

bash
docker run \
-v <<本地私钥路径>>:/tmp/key.pem \
--env AWS_ACCESS_KEY_ID=<<您的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<您的密钥>> \
--env AWS_DEFAULT_REGION=us-east-1 \
garland/aws-cli-docker \
aws ec2 get-password-data --instance-id <<您的实例ID>> --priv-launch-key /tmp/key.pem

输出示例：

json
{
    "InstanceId": "i-90949d7a",
    "Timestamp": "2014-12-11T01:18:27.000Z",
    "PasswordData": "8pa%o?foo"
}

参考文档：AWS CLI EC2获取密码数据

使用Docker Compose

1. 创建.env文件存储AWS凭据：

bash
echo AWS_ACCESS_KEY_ID=您的访问密钥 >> .env
echo AWS_SECRET_ACCESS_KEY=您的密钥 >> .env

2. 运行Docker Compose命令：

bash
docker-compose run aws s3 ls