jakesys/aws

镜像概述和主要用途

基于Alpine Linux的小型、简单Docker容器，用于运行AWS CLI v1。

该镜像基于官方alpine:latest镜像构建，并包含通过pip3安装的最新aws-cli软件包。

项目的权威代码仓库位于[***] CLI v1版本至Docker Hub上的jakesys/aws镜像。

如需使用AWS CLI v2，请参见[***] Hub上的jakesys/aws2。

核心功能和特性

• 基于Alpine Linux，镜像体积小
• 包含最新版本的AWS CLI v1
• 提供日志格式化选项，便于集成日志系统
• 支持自定义日志前缀格式

使用场景和适用范围

• CI/CD流水线中的AWS资源管理操作
• 临时需要AWS CLI环境的场景
• 多环境下保持AWS CLI版本一致性
• 需要将AWS CLI操作日志集中管理的场景

使用方法和配置说明

基本用法

docker run <docker选项> -v <aws配置目录>:/root/.aws jakesys/aws [--log | --logfmt <格式>] [<AWS CLI选项>] <命令> ...

参数说明

• -v <aws配置目录>:/root/.aws: 将本地AWS配置目录挂载到容器中，包含凭证和配置信息

额外选项

--log

在STDERR输出日志条目，以时间戳和容器的hostname开头。当使用'awslog'日志驱动时特别有用，可以避免每一行输出都成为单独的CloudWatch日志条目。需要使用awslogs-datetime-format='%Y-%m-%dT%H:%M:%SZ - '选项，使CloudWatch能够正确解析日志条目。

日志条目类型:

• START: 包含正在执行的aws命令行
• OUTPUT: 包含执行命令的STDOUT和STDERR混合输出
• EXIT: 包含命令的退出代码和持续时间(秒)

--logfmt <fmt>

在STDERR输出日志条目，前缀使用符合strftime(3)格式的字符串。如需包含aws容器的hostname，可在格式字符串中包含@{hostname}。例如，默认的--log格式等同于--logfmt '%FT%TZ - @{hostname} - '。

部署示例

1. 基本AWS CLI命令

# 挂载本地AWS配置并获取S3 bucket列表
docker run -v ~/.aws:/root/.aws jakesys/aws s3 ls

2. 使用日志格式化选项

# 使用默认日志格式执行AWS命令
docker run -v ~/.aws:/root/.aws jakesys/aws --log ec2 describe-instances

3. 自定义日志格式

# 使用自定义日志格式执行AWS命令
docker run -v ~/.aws:/root/.aws jakesys/aws --logfmt '[%Y-%m-%d %H:%M:%S] @{hostname} - ' s3 ls

4. 与awslogs驱动配合使用

docker run \
  --log-driver=awslogs \
  --log-opt awslogs-group=my-aws-cli-logs \
  --log-opt awslogs-datetime-format='%Y-%m-%dT%H:%M:%SZ - ' \
  -v ~/.aws:/root/.aws \
  jakesys/aws --log s3 sync localdir s3://bucket/path

5. Docker Compose配置

version: '3'
services:
  awscli:
    image: jakesys/aws
    volumes:
      - ~/.aws:/root/.aws
    command: ["--log", "s3", "ls"]
    logging:
      driver: "awslogs"
      options:
        awslogs-group: "my-aws-cli-logs"
        awslogs-datetime-format: "%Y-%m-%dT%H:%M:%SZ - "