如何拉取AWS ECS中大小写混合命名的Docker镜像

问题根源 #

Docker CLI强制要求镜像仓库名称全小写，而AWS ECR允许大小写混合命名，直接用原名称拉取就会触发invalid reference format: repository name must be lowercase错误。

可行解决方案 #

1. 使用全小写的ECR完整镜像URI拉取

AWS ECR的镜像可以通过全小写的仓库URI访问，只需把原镜像名称转成全小写，加上你的AWS账号ID和区域前缀即可。示例命令：

docker pull 123456789012.dkr.ecr.us-east-1.amazonaws.com/blastcomputeenvironment-g2nuvesecl8rckpi_batch_bfa38d06-e569-33b8-8691-ff38312a553a:latest

• 替换123456789012为你的AWS账号ID，us-east-1为实际区域，:latest为镜像标签（如果不是latest需修改）。

2. 通过AWS CLI导入镜像后重新打标签

如果直接用URI拉取仍有问题，可以先通过AWS工具把镜像导入本地Docker，再打全小写标签：

# 先登录ECR
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com

# 获取镜像manifest并导入Docker
aws ecr batch-get-image --repository-name BlastComputeEnvironment-G2nuvesECl8RckPI_Batch_bfa38d06-e569-33b8-8691-ff38312a553a --image-ids imageTag=latest --query 'images[].imageManifest' --output text > manifest.json
cat manifest.json | docker load

# 给导入的镜像打全小写标签（替换<IMAGE_ID>为导入后显示的镜像ID）
docker tag <IMAGE_ID> 123456789012.dkr.ecr.us-east-1.amazonaws.com/blastcomputeenvironment-g2nuvesecl8rckpi_batch_bfa38d06-e569-33b8-8691-ff38312a553a:latest

3. 在ECR中复制镜像到全小写仓库

如果需要长期解决这个问题，可以创建一个全小写的ECR仓库，把原镜像复制过去：

# 创建全小写仓库
aws ecr create-repository --repository-name blastcomputeenvironment-g2nuvesecl8rckpi_batch_bfa38d06-e569-33b8-8691-ff38312a553a --region us-east-1

# 复制镜像到新仓库
aws ecr batch-copy-image --source-region us-east-1 --source-registry-id 123456789012 --source-repository-name BlastComputeEnvironment-G2nuvesECl8RckPI_Batch_bfa38d06-e569-33b8-8691-ff38312a553a --source-image latest --destination-region us-east-1 --destination-registry-id 123456789012 --destination-repository-name blastcomputeenvironment-g2nuvesecl8rckpi_batch_bfa38d06-e569-33b8-8691-ff38312a553a

之后就可以用全小写的仓库名称正常拉取镜像了。

内容的提问来源于stack exchange，提问作者Joymaker