AWS ECR Dockercfg生成器镜像

镜像概述

AWS Elastic Container Registry (ECR) 要求Docker客户端使用临时凭证进行认证。本镜像的核心功能是将AWS凭证（如IAM访问密钥、临时安全凭证等）转换为符合Docker要求的dockercfg配置文件，使Docker客户端能够无缝认证并访问AWS ECR仓库。

核心功能与特性

• 凭证转换：将AWS凭证（包括长期访问密钥和临时安全凭证）转换为Docker可识别的dockercfg格式认证配置
• 临时凭证支持：兼容AWS IAM角色、STS临时凭证等场景，满足ECR对临时认证的安全要求
• 轻量高效：专注于核心转换功能，镜像体积小，运行效率高

使用场景与适用范围

• CI/CD流水线：在自动化构建流程中，通过本镜像生成dockercfg，实现Docker客户端与AWS ECR的认证，确保镜像推送/拉取操作顺利执行
• 容器化部署环境：在需要直接通过Docker命令行访问AWS ECR的服务器或开发环境中，快速生成认证配置
• 多环境适配：适用于使用AWS IAM角色（如EC2实例角色、EKS服务账户角色）或静态访问密钥的各类环境

使用方法与配置说明

环境变量配置

运行镜像时需通过环境变量提供AWS凭证信息，支持以下参数：

部署示例

1. 使用静态AWS访问密钥生成dockercfg

docker run --rm \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  -v /host/path/to/output:/dockercfg \
  [镜像名称]:[标签]

执行后，生成的dockercfg文件将保存至宿主机/host/path/to/output目录下。

2. 使用临时凭证（含会话令牌）生成dockercfg

docker run --rm \
  -e AWS_ACCESS_KEY_ID="ASIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  -e AWS_SESSION_TOKEN="sessionTokenExample" \
  -e ECR_REGISTRY_ID="123456789012" \
  -v /host/path/to/output:/dockercfg \
  [镜像名称]:[标签]

3. 配合Docker客户端使用

生成dockercfg后，可将其配置到Docker客户端：

# 将生成的dockercfg复制到Docker配置目录
cp /host/path/to/output/dockercfg ~/.docker/config.json

# 验证认证是否成功
docker login -u AWS [***]

注意事项

• 确保提供的AWS凭证具有访问目标ECR仓库的权限（如ecr:GetAuthorizationToken权限）
• 临时凭证（含AWS_SESSION_TOKEN）需在有效期内使用，过期后需重新生成
• 生产环境建议通过IAM角色（如EC2实例角色、EKS IRSA）自动获取凭证，避免暴露静态访问密钥