xueshanf/awscli

Docker awscli

镜像概述和主要用途

这是一个容器化的AWS CLI工具箱，包含AWS CLI及相关工具，用于在容器环境中执行AWS命令，无需本地安装AWS CLI依赖。镜像通过自动构建流程推送到Docker Hub仓库xueshanf/awscli。

核心功能和特性

• 集成AWS CLI和s3cmd工具，支持AWS服务管理
• 提供get-metadata工具，便捷获取EC2实例元数据（如实例ID、公网IP等）
• 命令行参数不区分大小写，使用灵活
• 支持通过环境变量或IAM角色两种方式提供AWS凭证
• 可通过重建镜像实现工具版本升级

使用场景和适用范围

• 临时需要执行AWS CLI命令的环境
• CI/CD流程中与AWS服务的自动化交互
• 跨平台执行AWS操作（避免本地依赖冲突）
• S3存储桶数据管理（上传/下载/同步）
• EC2实例与负载均衡器的注册/注销操作

使用方法和配置说明

检查工具版本

通过以下命令检查AWS CLI和s3cmd版本：

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

重建镜像（含工具升级）

克隆仓库并重新构建镜像，可自动升级工具包：

bash
git clone https://github.com/xueshanf/docker-awscli.git
cd docker-awscli
docker build -t xueshanf/awscli:latest .

get-metadata工具使用

get-metadata工具用于获取EC2实例元数据，支持以下参数（不区分大小写）：ACCOUNT、HOSTNAME、INSTANCEID、PRIVATEIP、PUBLICIP、ROLE、STSCRED、STSTOKEN、STSKEY、SECRET、ZONE。

查看帮助：

bash
docker run --rm docker.xuanyuan.run/xueshanf/awscli get-metadata help

示例：获取实例ID

bash
docker run --rm docker.xuanyuan.run/xueshanf/awscli get-metadata instanceid
# 输出示例：i-453266b2

从S3复制数据到本地文件系统

使用-v参数挂载本地目录，执行S3数据复制：

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

替换<bucket>为实际S3桶名称

注册EC2实例到负载均衡器

配置AWS凭证

若实例未配置IAM角色权限，需通过环境变量提供凭证。创建环境变量文件（如/root/.aws/envvars）：

AWS_ACCESS_KEY_ID=<key id>
AWS_SECRET_ACCESS_KEY=<access key>
AWS_DEFAULT_REGION=us-west-2

替换<key id>和<access key>为实际AWS访问凭证

执行注册脚本

创建注册脚本（如register_elb.sh）：

bash
#!/bin/bash
AWS_CONFIG_ENV=/root/.aws/envvars
INSTANCE=$(/usr/bin/curl -s http://169.254.169.254/latest/meta-data/instance-id)
IMAGE=xueshanf/awscli:latest

CMD="aws elb register-instances-with-load-balancer \
    --load-balancer-name <elb name> --instances $INSTANCE "

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

替换<elb name>为实际负载均衡器名称

赋予执行权限并运行：

bash
chmod +x register_elb.sh
./register_elb.sh