GitHub Actions构建Docker镜像时标签引用格式无效报错排查

问题原因 #

在docker/build-push-action的tags参数中直接写入shell命令$(date +'%Y-%m-%d%H-%M-%S')时，GitHub Actions不会执行该shell命令，而是将其作为纯字符串处理。而Docker镜像标签不允许包含$、(、)这类特殊字符，因此触发了"invalid reference format"错误。

解决方案 #

先通过单独的步骤生成时间戳并保存为环境变量，再在构建步骤中引用该环境变量作为标签后缀：

1. 添加生成时间戳的步骤

- name: Generate build timestamp
  run: echo "BUILD_TIMESTAMP=$(date +'%Y-%m-%d%H-%M-%S')" >> $GITHUB_ENV

2. 修改构建步骤的标签配置

- name: Build Docker image
  uses: docker/build-push-action@v2
  with:
    context: .
    dockerfile: Dockerfile
    push: false
    tags: ${{secrets.DOCKER_HUB_USERNAME}}/image-micro-service:${{env.BUILD_TIMESTAMP}}

完整Workflow示例 #

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Generate build timestamp
        run: echo "BUILD_TIMESTAMP=$(date +'%Y-%m-%d%H-%M-%S')" >> $GITHUB_ENV

      - name: Build Docker image
        uses: docker/build-push-action@v2
        with:
          context: .
          dockerfile: Dockerfile
          push: false
          tags: ${{secrets.DOCKER_HUB_USERNAME}}/image-micro-service:${{env.BUILD_TIMESTAMP}}

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