使用docker/build-push-action@v4推送至ECR出现无标签镜像问题求助

我配置了GitHub Action将镜像推送至Amazon ECR，但推送完成后，ECR中的镜像显示为无标签状态，无法识别镜像对应的平台等信息。请问这是工具bug还是我的配置错误？

我的GitHub Action配置如下：

name: push
on: [workflow_dispatch]
env:
  ECR_REPOSITORY: gha
jobs:
  build-image:
    name: Build Images
    runs-on: ubuntu-latest
    steps:
    
      - uses: actions/checkout@v3
 
      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v2
        with:
          aws-access-key-id: ${{ secrets.AWS_MGMT_ECR_ID }}
          aws-secret-access-key: ${{ secrets.AWS_MGMT_ECR_KEY }}
          aws-region: eu-west-2

      - name: Login to Amazon ECR
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v1

      - name: Set up QEMU
        uses: docker/setup-qemu-action@v2
        
      - name: Set up docker buildx
        uses: docker/setup-buildx-action@v2
 
      - name: Docker meta
        id: meta
        uses: docker/metadata-action@v4
        with:
          images: |
            ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}
          tags: |
            type=semver,pattern={{version}},value=1.0.0
        env:
          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
      
      - name: Docker build
        uses: docker/build-push-action@v4
        with:
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          platforms: linux/amd64,linux/arm64

ECR中的显示情况：

这是配置错误，并非工具bug，核心问题出在docker/metadata-action的环境变量作用域：

• 你将ECR_REGISTRY定义在Docker meta步骤的局部env中，但该步骤的images字段在解析时，局部环境变量还未生效，导致${{ env.ECR_REGISTRY }}为空值。
• 最终生成的镜像标签缺少ECR仓库地址，推送时无法正确关联到目标ECR仓库，因此ECR仅收到镜像manifest，但未绑定对应标签，最终显示为无标签状态。

修复配置 #

方案1：提前全局设置ECR_REGISTRY #

在Docker meta步骤前，将ECR_REGISTRY写入全局环境变量，确保后续步骤能读取到正确值：

name: push
on: [workflow_dispatch]
env:
  ECR_REPOSITORY: gha
jobs:
  build-image:
    name: Build Images
    runs-on: ubuntu-latest
    steps:
    
      - uses: actions/checkout@v3
 
      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v2
        with:
          aws-access-key-id: ${{ secrets.AWS_MGMT_ECR_ID }}
          aws-secret-access-key: ${{ secrets.AWS_MGMT_ECR_KEY }}
          aws-region: eu-west-2

      - name: Login to Amazon ECR
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v1

      # 提前将ECR_REGISTRY写入全局环境变量
      - name: Set ECR Registry env var
        run: echo "ECR_REGISTRY=${{ steps.login-ecr.outputs.registry }}" >> $GITHUB_ENV

      - name: Set up QEMU
        uses: docker/setup-qemu-action@v2
        
      - name: Set up docker buildx
        uses: docker/setup-buildx-action@v2
 
      - name: Docker meta
        id: meta
        uses: docker/metadata-action@v4
        with:
          images: |
            ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}
          tags: |
            type=semver,pattern={{version}},value=1.0.0
      
      - name: Docker build
        uses: docker/build-push-action@v4
        with:
          push: true
          tags: ${{ steps.meta.outputs.tags }}
          platforms: linux/amd64,linux/arm64
          # 可选：关闭provenance避免部分ECR兼容性问题（非必需）
          provenance: false

方案2：直接在images字段中引用步骤输出 #

跳过环境变量传递，直接在images字段中使用steps.login-ecr.outputs.registry：

# 仅修改Docker meta步骤
- name: Docker meta
  id: meta
  uses: docker/metadata-action@v4
  with:
    images: |
      ${{ steps.login-ecr.outputs.registry }}/${{ env.ECR_REPOSITORY }}
    tags: |
      type=semver,pattern={{version}},value=1.0.0

验证修复 #

重新触发GitHub Action后，ECR仓库中应能看到带有1.0.0标签的镜像，且可正常查看各平台的镜像详细信息。

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