ownlocal/ecr-auth-run

ownlocal/ecr-auth-run

镜像概述

本镜像通过执行aws ecr get-login完成AWS ECR（弹性容器 registry）认证，随后将传入的参数传递给docker run命令以启动目标容器。适用于需要运行ECR托管容器但无法直接进行认证的场景。

核心功能

1. 自动完成ECR认证流程
2. 传递任意参数至docker run命令
3. 支持IAM角色或AWS访问密钥两种认证方式
4. 需挂载Docker主机的socket和docker可执行文件以正常工作

使用场景

• 在RancherOS中通过cloud-config配置启动ECR容器
• 命令行直接运行ECR托管的容器
• 其他无法预先执行ECR认证的环境

配置说明

必要条件

1. 挂载/var/run/docker.sock和/usr/bin/docker（若Docker可执行文件路径不同需调整）
2. 设置环境变量：
   • AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY（使用访问密钥时）
   • AWS_DEFAULT_REGION（必须指定）
3. 若使用IAM角色，无需提供访问密钥，但仍需指定区域

部署示例

1. RancherOS cloud-config配置

#cloud-config
ssh_authorized_keys:
  - ssh-rsa SSH-KEY-HERE
rancher:
  services:
    my_container:
      image: ownlocal/ecr-auth-run
      command: [12345.dkr.ecr.us-east-1.amazonaws.com/my_container:latest, --log-driver=awslogs, --log-opt, awslogs-region=us-east-1, --log-opt, awslogs-group=MyLogGroup]
      environment:
        AWS_ACCESS_KEY_ID: AKIAIOSFODNN7EXAMPLE
        AWS_SECRET_ACCESS_KEY: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
        AWS_DEFAULT_REGION: us-east-1
      privileged: true
      volumes:
        - /var/run/docker.sock:/var/run/docker.sock
        - /usr/bin/docker:/usr/bin/docker

2. 命令行运行

bash
docker run --rm -it \
  -e AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY \
  -e AWS_DEFAULT_REGION=us-east-1 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin/docker:/usr/bin/docker \
  ownlocal/ecr-auth-run \
  --log-driver=awslogs --log-opt awslogs-region=us-east-1 --log-opt awslogs-group=MyLogGroup \
  12345.dkr.ecr.us-east-1.amazonaws.com/my-container

注意：docker run参数需放在目标镜像名称前，容器参数需放在目标镜像名称后；使用awslogs日志驱动时，需确保环境具备CloudWatch日志权限。