brainstation/awscli

awscli

包含AWS CLI的Docker镜像

镜像概述

该镜像包含AWS CLI（Amazon Web Services Command Line Interface），支持V1和V2版本，适用于在容器环境中执行AWS相关命令操作。由于主要面向CI（持续集成）场景，镜像中还集成了https://stedolan.github.io/jq/工具，用于解析AWS CLI的响应结果。

标签模式

• 2, latest, 2-amazonlinux, latest-amazonlinux
• 2.x, 2.x-amazonlinux
• 2.x.x, 2.x.x-amazonlinux
• 2-ubuntu, latest-ubuntu
• 2.x-ubuntu
• 2.x.x-ubuntu
• 1
• 1.x
• 1.x.x

所有可用标签可在https://hub.docker.com/r/brainstation/awscli/tags查看。

https://hub.docker.com/r/brainstation/awscli

镜像标签对应https://github.com/aws/awscli的发布标签。当https://github.com/aws/awscli有新发布标签时，`latest`标签将更新，新标签将在**8小时内**添加。

核心功能与特性

• 多版本支持：同时支持AWS CLI V1和V2版本，满足不同兼容性需求
• 工具集成：内置jq工具，方便解析AWS CLI返回的JSON格式响应
• 自动更新：跟随AWS CLI官方版本更新，新标签8小时内同步
• 多基础镜像：提供基于Amazon Linux和Ubuntu的镜像版本，适应不同环境需求

使用场景

• CI/CD流程：在持续集成/持续部署 pipeline 中执行AWS资源操作（如S3上传、ECS部署等）
• 本地开发测试：在隔离容器环境中测试AWS CLI命令，避免本地环境配置冲突
• 自动化脚本：作为AWS相关自动化脚本的运行环境，确保依赖一致性

使用方法

前提条件

主机需有有效的AWS凭证文件~/.aws/credentials。配置方法可参考https://github.com/aws/awscli#getting-started。

使用docker命令

bash
$ docker run \
--mount type=bind,src=$HOME/.aws,dst=/root/.aws \
--rm \
brainstation/awscli:2 \
aws sts get-caller-identity
{
  "UserId": "<用户ID>",
  "Account": "<账户编号>",
  "Arn": "<用户或角色ARN>"
}

使用docker-compose

docker-compose.yml

yml
version: '3'
services:
  who-am-i-1:
    image: docker.xuanyuan.run/brainstation/awscli:latest
    working_dir: /opt/code
    volumes:
      - .:/opt/code
      - $HOME/.aws:/root/.aws
    command: ./task.sh

  who-am-i-2:
    image: docker.xuanyuan.run/brainstation/awscli:latest
    volumes:
      - $HOME/.aws:/root/.aws
    command: bash -c -e "
      aws sts get-caller-identity &&
      echo \"Hello World!\"
      "

task.sh

bash
#!/usr/bin/env bash

UserId=$(aws sts get-caller-identity | jq -r '.UserId')
echo "My user id: $UserId"

执行输出

bash
$ docker-compose run --rm who-am-i-1
My user id: ABCDEFG3H5IJK4NXYAYJ4
$ docker-compose run --rm who-am-i-2
{
  "UserId": "<用户ID>",
  "Account": "<账户编号>",
  "Arn": "<用户或角色ARN>"
}
Hello World!