sgreben/awscli-with-assume-role

awscli-with-assume-role

![Docker Repository on Quay]([] ![pipeline status]([]

镜像概述和主要用途

该镜像提供一个名为with-assume-role的包装器工具，用于在指定的IAM角色下运行命令。角色由环境变量ASSUME_ROLE_ARN定义。镜像会自动跟踪awscli的最新官方版本，通过Renovate、Gitlab CI以及Quay.io/DockerHub构建系统，将更新同步至./requirements.txt并生成带版本标签的Docker镜像（例如sgreben/awscli-with-assume-role:1.16.196）。

核心功能和特性

• 提供with-assume-role包装器，支持在承担的IAM角色上下文下执行命令
• 自动跟踪并集成awscli最新官方版本，确保工具时效性
• 通过环境变量灵活配置要承担的IAM角色
• 轻量级设计，专注于角色承担功能与AWS CLI的无缝集成

使用场景和适用范围

适用于需要临时获取或切换IAM角色权限来执行AWS CLI命令的场景，包括但不限于：

• 跨AWS账户资源操作
• 临时提升权限执行特定管理任务
• CI/CD流水线中需要特定角色权限的自动化操作
• 多角色环境下的权限隔离与切换

使用方法和配置说明

环境变量配置

拉取镜像

bash
docker pull sgreben/awscli-with-assume-role

基本使用示例

1. 配置环境变量：

bash
export ASSUME_ROLE_ARN=arn:aws:iam::123456789012:role/demo
export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key

2. 运行容器并执行命令：

bash
docker run --rm -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e ASSUME_ROLE_ARN \
    sgreben/awscli-with-assume-role \
    with-assume-role aws sts get-caller-identity

若角色承担成功，上述命令将输出类似以下内容（包含所承担角色的ARN）：

{
    "Account": "123456789012",
    "UserId": "AROAEXAMPLEID:session-name",
    "Arn": "arn:aws:iam::123456789012:role/demo"
}