GitHub Actions构建镜像至AWS ECR时标签无法更新问题求助

1. 用唯一标识符彻底避免标签重复问题 #

最直接的解决方案是给每次构建的镜像分配唯一标签，比如GitHub提交的SHA哈希、流水线运行ID或者时间戳，这样永远不会出现标签冲突。

在GitHub Actions中可以直接用内置变量生成唯一标签：

# 用提交SHA前7位作为标签（足够唯一）
IMAGE_TAG="${{ github.sha }}"
# 或者用时间戳生成唯一标签
IMAGE_TAG=$(date +%Y%m%d%H%M%S)
# 构建镜像
docker build -t 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$IMAGE_TAG .
# 推送唯一标签镜像
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$IMAGE_TAG

2. 正确更新latest标签的流程 #

ECR默认禁止直接覆盖现有标签，要更新latest标签必须先删除远程旧标签，再重新推送：

# 基于刚推送的唯一标签镜像，给本地镜像打上latest标签
docker tag 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$IMAGE_TAG 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:latest

# 检查远程是否存在latest标签，存在则删除
if aws ecr describe-images --repository-name my-image --image-ids imageTag=latest >/dev/null 2>&1; then
  aws ecr batch-delete-image --repository-name my-image --image-ids imageTag=latest
fi

# 推送最新的latest标签
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:latest

3. 自定义版本号标签的自动递增（如果需要） #

如果你想用v1.0.1这类版本号标签，必须确保脚本读取的是ECR远程的最新标签，而非本地缓存。以下是bash脚本示例：

# 获取ECR仓库中最新的版本标签（假设标签格式为vX.X.X）
LATEST_TAG=$(aws ecr describe-images --repository-name my-image --query 'sort_by(imageDetails,& imagePushedAt)[-1].imageTags[0]' --output text)

# 处理仓库为空的初始情况
if [ -z "$LATEST_TAG" ]; then
  NEW_TAG="v1.0.0"
else
  # 提取版本号并递增第三位
  VERSION=$(echo $LATEST_TAG | sed 's/^v//')
  NEW_VERSION=$(echo $VERSION | awk -F. '{printf "%d.%d.%d", $1, $2, $3+1}')
  NEW_TAG="v$NEW_VERSION"
fi

# 构建并推送新版本标签
docker build -t 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$NEW_TAG .
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$NEW_TAG

# 同步更新latest标签
docker tag 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:$NEW_TAG 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:latest
if aws ecr describe-images --repository-name my-image --image-ids imageTag=latest >/dev/null 2>&1; then
  aws ecr batch-delete-image --repository-name my-image --image-ids imageTag=latest
fi
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-image:latest

4. GitHub Actions中的关键注意事项 #

• 确保AWS IAM角色/用户拥有ecr:DescribeImages、ecr:BatchDeleteImage、ecr:PushImage等必要权限；
• 每次构建前清理本地镜像缓存，避免旧标签干扰：docker system prune -af；
• 推荐使用官方的aws-actions/amazon-ecr-login Action简化ECR登录流程，无需手动执行docker login。

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