akiunlocks/awscli

Alpine-Python3-AWSCLI 镜像文档

镜像概述

Alpine-Python3-AWSCLI是一款基于Alpine Linux的轻量级Docker镜像，预装了Python 3和AWS Command Line Interface (AWS CLI)工具。该镜像旨在为需要同时使用Python脚本能力和AWS服务管理功能的场景提供精简、高效的运行环境，充分利用Alpine Linux的小体积特性，减少资源占用并加快容器启动速度。

核心功能与特性

轻量级基础

• 基于Alpine Linux构建，镜像体积小（通常小于100MB），启动速度快，适合资源受限环境或对部署效率有要求的场景。
• 继承Alpine Linux的安全性设计，默认包含最小化依赖，降低***面。

预装核心工具

• Python 3：提供完整的Python 3运行环境，支持执行Python脚本及安装PyPI依赖（通过pip）。
• AWS CLI：预装AWS官方命令行工具，支持与AWS所有服务（如S3、EC2、Lambda等）进行交互，版本与Alpine官方源同步。

兼容性与灵活性

• 支持标准Docker容器操作，可通过环境变量或挂载配置文件自定义Python依赖和AWS CLI配置。
• 兼容Alpine Linux的包管理工具（apk），可按需扩展安装额外系统依赖。

使用场景

1. CI/CD流程集成：在持续集成/部署 pipeline 中执行AWS资源操作（如上传文件至S3、触发Lambda函数、更新ECS服务等）。
2. Python脚本运行环境：运行依赖AWS服务的Python自动化脚本（如数据同步、日志分析、资源监控等）。
3. 轻量级AWS管理工具：作为临时或便携的AWS命令行管理环境，避免在本地系统直接安装依赖。
4. 微服务辅助组件：在微服务架构中作为辅助容器，执行与AWS相关的初始化或周期性任务。

使用方法

基础运行

通过以下命令启动交互式容器，验证环境：

bash
docker run -it --rm your-image-name sh

进入容器后，可分别验证Python和AWS CLI版本：

bash
# 验证Python版本
python3 --version

# 验证AWS CLI版本
aws --version

执行Python脚本

将本地Python脚本挂载到容器中执行（假设脚本路径为./script.py）：

bash
docker run --rm -v $(pwd)/script.py:/app/script.py your-image-name python3 /app/script.py

使用AWS CLI管理AWS资源

配置AWS凭证

AWS CLI需要通过凭证（Access Key ID和Secret Access Key）访问AWS服务，推荐通过以下两种方式配置：

1. 环境变量注入（适用于容器化环境）：

   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" \
     your-image-name \
     aws s3 ls  # 示例：列出S3存储桶
   

2. 挂载本地AWS配置文件（适用于开发环境）： 将本地~/.aws/credentials和~/.aws/config文件挂载到容器的/root/.aws/目录：

   bash
   docker run --rm \
     -v ~/.aws:/root/.aws \
     your-image-name \
     aws ec2 describe-instances  # 示例：查询EC2实例
   

执行AWS CLI命令示例

• 上传文件至S3：

  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" \
    -v $(pwd)/local-file.txt:/tmp/local-file.txt \
    your-image-name \
    aws s3 cp /tmp/local-file.txt s3://your-bucket/path/
  

• 调用Lambda函数：

  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" \
    your-image-name \
    aws lambda invoke --function-name your-function --payload '{"key": "value"}' output.json
  

扩展安装依赖

如需安装额外Python包或系统依赖，可在容器启动时执行安装命令，或通过Dockerfile基于此镜像构建自定义镜像：

bash
# 临时安装Python包（示例：安装boto3）
docker run -it --rm your-image-name sh -c "pip install boto3 && python3"

# 构建自定义镜像（Dockerfile示例）
FROM your-image-name
RUN pip install boto3  # 安装Python依赖
RUN apk add --no-cache jq  # 安装系统工具（如jq）

注意事项

• AWS凭证安全：避免在镜像中硬编码AWS凭证，优先通过环境变量或挂载配置文件注入，生产环境建议使用IAM角色（如EKS Pod Identity、ECS Task Role）。
• Alpine兼容性：部分Python包可能依赖系统库，需通过apk add安装对应依赖（如gcc、musl-dev等）。
• 镜像更新：定期更新基础镜像以获取Alpine、Python3及AWS CLI的安全补丁。