kargoglobal/awscli

AWS CLI Docker镜像

镜像概述与主要用途

本镜像为预装AWS CLI（Amazon Web Services命令行界面）的Docker镜像，旨在提供一个即开即用的容器化环境，使用户无需在宿主机系统中安装配置AWS CLI，即可直接通过容器执行与AWS服务的交互操作。适用于开发、测试及自动化场景中对AWS资源的管理与操作。

核心功能与特性

• 预装AWS CLI：镜像内置AWS CLI工具，支持所有AWS服务的命令行操作
• 轻量级基础：基于轻量级Linux发行版构建，镜像体积小，启动速度快
• 环境隔离：容器化运行环境，避免与宿主机系统配置冲突
• 完整命令支持：支持AWS CLI全部命令集，包括服务管理、资源操作、权限配置等
• 易于集成：可无缝集成到CI/CD流水线、自动化脚本及容器编排系统中

使用场景与适用范围

• 开发环境：本地开发时快速管理AWS测试资源，无需在开发机全局安装AWS CLI
• 自动化脚本：执行AWS资源备份、数据迁移、服务部署等自动化任务
• CI/CD流水线：在持续集成/持续部署流程中执行AWS相关操作（如S3文件上传、ECS服务更新）
• 多环境隔离：通过不同容器实例配置不同AWS凭证，实现开发/测试/生产环境的操作隔离
• 临时任务：临时执行AWS资源查询、配置修改等一次性操作

使用方法与配置说明

获取镜像

通过Docker命令拉取镜像（假设镜像名称为awscli，具体名称以实际镜像仓库为准）：

bash
docker pull awscli

基本使用

验证安装

运行容器并检查AWS CLI版本：

bash
docker run --rm awscli aws --version

执行基本命令

直接在容器中执行AWS CLI命令（需先配置凭证，见下文）：

bash
docker run --rm awscli aws s3 ls

配置AWS凭证

使用AWS CLI前需配置有效的AWS访问凭证（Access Key ID和Secret Access Key），支持以下两种方式：

方式1：环境变量传递

通过-e参数传入AWS凭证环境变量：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_DEFAULT_REGION="us-east-1" \
  awscli aws ec2 describe-instances

方式2：挂载凭证文件

将本地AWS凭证文件（通常位于~/.aws/credentials）挂载到容器内对应路径：

bash
docker run --rm \
  -v ~/.aws/credentials:/root/.aws/credentials:ro \
  -v ~/.aws/config:/root/.aws/config:ro \
  awscli aws s3 mb s3://my-new-bucket

持久化配置

如需在容器重启后保留AWS CLI配置（如常用命令别名、输出格式设置），可挂载配置目录：

bash
docker run -it \
  -v ~/.aws:/root/.aws \
  --name awscli-persistent \
  awscli /bin/sh

在容器内执行aws configure完成配置后，配置将持久化到宿主机~/.aws目录。

使用示例

示例1：列出EC2实例

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_DEFAULT_REGION="us-west-2" \
  awscli aws ec2 describe-instances --query "Reservations[].Instances[].InstanceId"

示例2：通过docker-compose集成

创建docker-compose.yml文件：

yaml
version: '3'
services:
  awscli:
    image: awscli
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
      - AWS_DEFAULT_REGION=eu-central-1
    volumes:
      - ./aws-scripts:/scripts
    command: sh /scripts/deploy.sh

执行自动化部署脚本：

bash
docker-compose up

示例3：临时交互式操作

启动交互式容器进行多步AWS操作：

bash
docker run -it --rm \
  -v ~/.aws/credentials:/root/.aws/credentials:ro \
  awscli /bin/sh

在容器内交互式执行命令：

bash
aws s3 ls
aws cloudformation list-stacks
aws iam list-users