Jenkins构建Docker镜像成功但无法推送至Amazon ECR问题求助

云上老周

2026-8-16

解决Docker镜像推送Amazon ECR失败的问题

排查与修复步骤

1. 修正ECR Registry URL格式

你的vprofileRegistry变量带了https://前缀，但Jenkins的docker.withRegistry方法中，ECR的registry地址不需要该前缀，错误格式会导致Docker登录失败，进而引发推送重试超时。

修改环境变量：

environment {
    registryCredential = 'ecr:us-east-1:aws-cred'
    appRegistry = "xxxxxx.dkr.ecr.us-east-1.amazonaws.com/myappimg"
    vprofileRegistry = "xxxxxxx.dkr.ecr.us-east-1.amazonaws.com" // 移除https://前缀
    dockerImage = ''
}

2. 验证Jenkins凭证与IAM权限

确认aws-cred是Amazon ECR类型凭证，而非普通用户名密码凭证
关联的IAM用户/角色必须具备以下ECR权限：
- ecr:GetAuthorizationToken
- ecr:BatchCheckLayerAvailability
- ecr:GetDownloadUrlForLayer
- ecr:BatchGetImage
- ecr:InitiateLayerUpload
- ecr:UploadLayerPart
- ecr:CompleteLayerUpload
- ecr:PutImage

3. 确认镜像与ECR仓库匹配

检查ECR控制台是否已创建myappimg仓库
核对appRegistry中的AWS账号ID、区域与实际ECR仓库信息完全一致

4. 手动测试连通性

在Jenkins代理服务器上执行以下命令，验证基础功能是否正常：

# 获取ECR登录令牌并完成登录
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin xxxxxx.dkr.ecr.us-east-1.amazonaws.com
# 手动推送测试镜像
docker push xxxxxx.dkr.ecr.us-east-1.amazonaws.com/myappimg:test

若手动推送失败，可根据终端报错直接定位问题（如网络阻断、权限不足等）。