执行docker compose push时Docker镜像被跳过，如何推送至AWS ECR？

核心原因 #

Docker Compose push 只会推送带有完整远程仓库地址标签的镜像，你的本地镜像没有关联AWS ECR的仓库地址，因此被直接跳过。

必须完成的配置和步骤 #

1. 给Docker Compose服务指定ECR镜像标签 #

在docker-compose.yml中，为每个服务的image字段配置ECR仓库的完整地址，格式为：
{AWS账号ID}.dkr.ecr.{区域}.amazonaws.com/{仓库名}:{标签}

示例配置：

services:
  server:
    build: ./server
    image: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-project/server:v1
  frontend:
    build: ./frontend
    image: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-project/frontend:v1
  compiler:
    build: ./compiler
    image: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-project/compiler:v1

• 替换{AWS账号ID}为你的实际AWS账号ID
• 替换{区域}为ECR仓库所在的AWS区域（比如ap-southeast-1）
• {仓库名}可以是你提前创建的ECR仓库名称，每个服务可对应独立仓库，也可共用同一仓库搭配不同标签

2. 重新构建镜像 #

修改完配置后，重新执行构建命令，让本地镜像带上ECR的合规标签：

docker-compose build

3. 登录AWS ECR仓库 #

推送前必须先完成ECR登录，执行以下命令（替换对应区域和账号ID）：

aws ecr get-login-password --region {区域} | docker login --username AWS --password-stdin {AWS账号ID}.dkr.ecr.{区域}.amazonaws.com

确保本地已配置好AWS CLI，且拥有ECR推送的权限。

4. 执行推送命令 #

现在再执行推送，镜像就不会被跳过了：

docker compose push

额外检查项 #

• 确认目标ECR仓库已经提前创建完成
• 确保AWS权限配置包含ecr:BatchCheckLayerAvailability、ecr:CompleteLayerUpload、ecr:InitiateLayerUpload、ecr:PutImage、ecr:UploadLayerPart这些推送所需权限

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