leaflinkengineering/llp-awscli

AWS CLI v2 Docker镜像（llp-local专用）

镜像概述

本镜像为AWS CLI v2的Docker化版本，专为llp-local环境设计，提供了一个独立、可移植的AWS命令行工具运行环境。通过容器化部署，可避免本地环境配置冲突，简化AWS CLI的安装与使用流程，适用于需要在llp-local环境中执行AWS资源管理、数据操作等命令的场景。

核心功能与特性

• 基于AWS CLI v2：集成最新的AWS CLI v2版本，支持AWS服务的全量命令与功能
• Docker化部署：无需本地安装AWS CLI，通过容器即可快速启动并使用
• llp-local兼容：针对llp-local环境进行适配，确保命令执行与环境集成的稳定性
• 轻量级设计：基于精简基础镜像构建，降低资源占用
• 灵活配置：支持通过环境变量或挂载配置文件自定义AWS访问凭证与区域设置

使用场景与适用范围

• llp-local开发环境中执行AWS资源管理命令（如S3操作、EC2管理等）
• 需要临时使用AWS CLI且不想污染本地环境的场景
• CI/CD流程中集成AWS CLI操作步骤
• 多环境切换时保持AWS CLI版本与配置一致性

使用方法与配置说明

基本使用（docker run）

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=<your-access-key> \
  -e AWS_SECRET_ACCESS_KEY=<your-secret-key> \
  -e AWS_DEFAULT_REGION=<your-region> \
  docker.xuanyuan.run/aws-cli-v2-llp-local \
  aws <command>

参数说明：

• --rm：容器退出后自动删除
• -e：设置环境变量，用于配置AWS访问凭证与区域
• aws <command>：替换为具体的AWS CLI命令（如s3 ls、ec2 describe-instances等）

挂载本地配置文件

若需使用本地AWS配置文件（~/.aws/credentials和~/.aws/config），可通过挂载卷的方式实现：

bash
docker run --rm \
  -v ~/.aws:/root/.aws \
  docker.xuanyuan.run/aws-cli-v2-llp-local \
  aws <command>

常用环境变量

示例：执行S3列表命令

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret \
  -e AWS_DEFAULT_REGION=us-west-2 \
  docker.xuanyuan.run/aws-cli-v2-llp-local \
  aws s3 ls s3://my-bucket/

注意事项

• 确保提供的AWS访问凭证具有足够的操作权限
• 敏感凭证信息建议通过环境变量注入或挂载本地配置文件，避免硬编码在命令中
• 如需持久化存储命令执行结果，可挂载本地目录（如-v $(pwd):/work）将结果输出到宿主机