hiroshui/awscli

AWS CLI Docker镜像文档

镜像概述

该Docker镜像基于Ubuntu系统构建，集成了AWS CLI（Amazon Web Services命令行工具），旨在提供便捷的AWS服务管理环境。用户无需在本地系统安装AWS CLI及其依赖，通过容器即可直接执行AWS命令，简化云资源操作流程。

核心功能与特性

• 基于Ubuntu系统：提供稳定可靠的运行环境，兼容主流Linux命令
• 预安装AWS CLI：集成最新版本AWS命令行工具，支持所有AWS服务操作
• 轻量级设计：优化镜像体积，减少资源占用，启动快速
• 灵活身份验证：支持通过环境变量或AWS配置文件进行身份验证
• 全功能兼容：支持EC2、S3、Lambda、DynamoDB等所有AWS服务的命令行操作

使用场景

• 开发环境快速部署：临时需要使用AWS CLI但不想在本地系统安装时
• CI/CD流程集成：在自动化流水线中执行AWS资源部署、配置更新等操作
• 多环境隔离管理：通过不同容器实例配置不同AWS账号或区域，实现环境隔离
• 教学与演示：快速搭建AWS CLI操作环境，无需复杂的本地配置

使用方法与配置说明

基本使用

获取镜像并查看版本：

bash
docker run --rm -it amazon/aws-cli:latest --version

身份验证方式

1. 环境变量方式

通过环境变量传递AWS凭证（推荐用于临时操作）：

bash
docker run --rm -it \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-east-1" \
  amazon/aws-cli s3 ls

2. 配置文件方式

挂载本地AWS配置文件（推荐用于长期使用）：

bash
docker run --rm -it \
  -v ~/.aws:/root/.aws \
  amazon/aws-cli ec2 describe-instances

本地配置文件路径通常为 ~/.aws/credentials 和 ~/.aws/config

常用命令示例

• 列出S3存储桶：

  bash
  docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli s3 ls
  

• 描述EC2实例：

  bash
  docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli ec2 describe-instances --region us-west-2
  

• 创建Lambda函数：

  bash
  docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/app amazon/aws-cli lambda create-function \
    --function-name my-function \
    --runtime python3.9 \
    --role arn:aws:iam::123456789012:role/lambda-role \
    --handler lambda_function.lambda_handler \
    --zip-file fileb:///app/lambda-deploy.zip
  

Docker Compose配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  aws-cli:
    image: amazon/aws-cli:latest
    volumes:
      - ~/.aws:/root/.aws  # 挂载本地AWS配置
      - ./aws-scripts:/scripts  # 挂载本地脚本目录
    environment:
      - AWS_REGION=us-east-1  # 默认区域
    tty: true
    stdin_open: true

启动容器：

bash
docker-compose up -d

进入容器执行命令：

bash
docker-compose exec aws-cli /bin/bash

注意事项

• 确保AWS凭证（Access Key和Secret Key）具有适当的权限
• 敏感操作建议使用配置文件方式而非环境变量，避免凭证泄露
• 定期更新镜像以获取最新版本的AWS CLI和安全补丁
• 执行文件操作时，确保本地目录正确挂载到容器内相应路径