bringmeister/docker-awscli

Docker awscli镜像说明

镜像概述

本镜像提供容器化的AWS CLI工具箱，包含AWS CLI、s3cmd及自定义工具（如get-metadata），支持在无本地AWS CLI环境下执行AWS云服务相关操作，镜像会自动构建并推送到Docker Hub。

核心功能

• 执行AWS CLI命令（S3操作、ELB实例注册等）
• 用s3cmd管理S3数据
• 内置get-metadata工具快速获取实例元数据（实例ID、私有IP、IAM角色等）
• 支持环境变量传递AWS凭证或实例IAM角色权限

使用场景

1. 本地无AWS CLI时通过容器执行AWS命令
2. 批量复制S3存储桶数据到本地
3. 自动化将实例注册到负载均衡器
4. 快速获取实例元数据信息

配置说明

• 凭证传递：通过--env-file加载含AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION的环境变量文件
• IAM角色：若实例已配置IAM角色，无需传递凭证，自动使用角色权限

部署示例

查看工具版本

bash
docker run --rm xueshanf/awscli aws --version
docker run --rm xueshanf/awscli s3cmd --version

获取实例元数据

bash
# 获取实例ID
docker run --rm xueshanf/awscli get-metadata instanceid
# 获取私有IP
docker run --rm xueshanf/awscli get-metadata privateip

复制S3数据到本地

bash
docker run --rm -v /var/apps:/apps xueshanf/awscli:latest aws s3 cp s3://<bucket>/apps/nginx/ /apps/nginx

注册实例到负载均衡器

1. 创建环境变量文件（如/root/.aws/envvars）：

env
AWS_ACCESS_KEY_ID=<你的Access Key ID>
AWS_SECRET_ACCESS_KEY=<你的Secret Access Key>
AWS_DEFAULT_REGION=us-west-2

2. 执行注册脚本：

bash
#!/bin/bash
AWS_CONFIG_ENV=/root/.aws/envvars
INSTANCE=$(/usr/bin/curl -s [***]
IMAGE=xueshanf/awscli:latest

CMD="aws elb register-instances-with-load-*** \
    --load-***-name <你的ELB名称> --instances $INSTANCE "

docker pull $IMAGE
docker run --rm --env-file=$AWS_CONFIG_ENV $IMAGE /bin/bash -c "$CMD"