mergermarket/switch-role

mergermarket/switch-role 镜像文档

镜像概述

mergermarket/switch-role是一个简单的Docker镜像，主要用途是帮助用户切换IAM角色到指定的AWS账户，通过容器化方式安全便捷地管理跨账户的权限切换。

核心功能与特性

• 支持通过环境变量传递AWS凭证（访问密钥、密钥和会话令牌）
• 提供命令行参数指定目标账户、角色名称和角色会话名称
• 自动处理角色会话名称中的无效字符并进行截断，确保兼容性
• 轻量级设计，使用后自动清理容器（--rm参数）

使用场景

• CI/CD流程中（如Jenkins作业）需要临时切换到目标AWS账户执行操作
• 需要在不同AWS账户间切换IAM角色的开发或运维场景
• 希望通过容器化方式隔离权限切换过程，提高操作安全性

使用方法与配置说明

直接运行命令

bash
SAVE_XTRACE_STATUS="$(set +o | grep xtrace)"; set +x
eval "$( docker run --rm -i -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN  \
    mergermarket/switch-role --account accountname --role-name admin --role-session-name "$JOB_NAME" \
)"
eval "$SAVE_XTRACE_STATUS"; unset SAVE_XTRACE_STATUS

定义为bash函数（推荐）

为提高可读性和复用性，可将切换逻辑定义为bash函数：

bash
switch_role(){
    SAVE_XTRACE_STATUS="$(set +o | grep xtrace)"; set +x
    eval "$( docker run --rm -i -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN  \
        mergermarket/switch-role --account "$1" --role-name "$2" --role-session-name "$JOB_NAME" \
    )"
    eval "$SAVE_XTRACE_STATUS"; unset SAVE_XTRACE_STATUS
}

# 使用示例
switch_role accountname admin

参数说明

环境变量

注意事项

• --role-session-name参数在使用IAM用户凭证时是必需的，镜像会自动移除其中的无效字符并进行截断处理
• set +x和eval "$SAVE_XTRACE_STATUS"用于临时关闭命令跟踪输出，避免敏感信息泄露
• 使用--rm参数确保容器在使用后自动删除，避免残留容器占用资源