使用docker/metadata-action@v5生成Docker镜像标签失败求助

场景与配置 #

尝试结合metadata-action@v5与docker/build-push-action@v6实现：非main分支运行工作流时生成时间戳标签，默认main分支使用latest标签。工作流核心片段如下：

# ...
- name: Docker metadata
      id: metadata
      uses: docker/metadata-action@v5
      with:
        images: |
          ${{ steps.login-ecr.outputs.registry }}/${{ env.ECR_REPOSITORY }}
        tags: |
          type=schedule,pattern={{date 'YYYYMMDD-hhmmss' tz='Europe/London'}},enable=${{ github.ref_name != 'main' }}
          type=raw,value=latest,enable={{is_default_branch}}

    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v3

    - name: Build, tag, and push image to Amazon ECR
      id: build-image
      uses: docker/build-push-action@v6
      with:
        context: .
        file: Dockerfile
        push: true
        tags: ${{ steps.metadata.outputs.tags }}
        cache-from: ${{ steps.login-ecr.outputs.registry }}/${{ env.ECR_REPOSITORY }}:latest
        build-args: BUILDKIT_INLINE_CACHE=1
        provenance: false
# ...

错误表现 #

非main分支运行时，build-image步骤直接失败，报错：

ERROR: tag is needed when pushing to registry
Error: buildx failed with: ERROR: tag is needed when pushing to registry

同时metadata步骤输出两条关键警告：

Processing images input
  name=xxxxxxxxx.dkr.ecr.eu-west-2.amazonaws.com/xxxxx/xxxxx,enable=true
Processing tags input
  type=schedule,pattern={{date 'YYYYMMDD-hhmmss' tz='Europe/London'}},enable=true,priority=1000
  type=raw,value=latest,enable={{is_default_branch}},priority=200
Processing flavor input

Warning: No Docker image version has been generated. Check tags input.
Warning: No Docker tag has been generated. Check tags input.

问题根源 #

type=schedule类型的标签仅在GitHub调度触发的工作流中生效，而非main分支的工作流通常由分支推送、PR触发等方式启动，所以即使enable设为true，该标签也不会被生成，最终导致推送时无可用标签。

解决方法 #

方案1：直接使用GitHub内置变量生成标签 #

替换schedule类型标签为raw类型，结合GitHub Actions的运行编号或时间变量生成唯一标签：

- name: Docker metadata
  id: metadata
  uses: docker/metadata-action@v5
  with:
    images: |
      ${{ steps.login-ecr.outputs.registry }}/${{ env.ECR_REPOSITORY }}
    tags: |
      # 非main分支用「运行编号-时间戳」作为标签
      type=raw,value=${{ github.run_number }}-${{ github.run_attempt }}-${{ env.GITHUB_RUN_ID }},enable=${{ github.ref_name != 'main' }}
      # main分支用latest标签（使用action内置变量判断默认分支）
      type=raw,value=latest,enable={{is_default_branch}}

方案2：自定义时间戳格式 #

如果需要更易读的时间格式，先添加步骤生成指定格式的时间戳，再在metadata中引用：

# 新增时间戳生成步骤
- name: Generate custom timestamp
  id: date
  run: echo "timestamp=$(date +'%Y%m%d-%H%M%S')" >> "$GITHUB_OUTPUT"
  if: github.ref_name != 'main'

# 修改metadata步骤的tags配置
- name: Docker metadata
  id: metadata
  uses: docker/metadata-action@v5
  with:
    images: |
      ${{ steps.login-ecr.outputs.registry }}/${{ env.ECR_REPOSITORY }}
    tags: |
      type=raw,value=${{ steps.date.outputs.timestamp }},enable=${{ github.ref_name != 'main' }}
      type=raw,value=latest,enable={{is_default_branch}}

注意事项 #

• 避免混用GitHub Actions表达式与metadata-action内置模板变量：{{is_default_branch}}是action内置变量，不需要用${{}}包裹，可直接在enable参数中使用；
• 确保至少有一个标签规则在当前触发场景下生效，否则会再次出现无标签的报错。

内容的提问来源于stack exchange，提问作者vin'm