使用docker/build-push-action推送至GCR：环境变量标签报错求助

问题原因 #

在GitHub Actions的env配置块中，直接使用$PROJECT_ID这类shell风格的变量引用不会被自动解析。你当前定义的IMAGE: gcr.io/$PROJECT_ID/$APP_NAME:$GITHUB_SHA里的$PROJECT_ID、$GITHUB_SHA会被当作纯文本字符串保留，没有替换为实际的环境变量值。Docker收到包含$符号的标签后，判定为无效的镜像引用格式，因此抛出invalid reference format错误。

解决方案 #

提供两种可行的修复方式：

方式一：在env块中使用GitHub Actions表达式语法拼接变量 #

修改jobs.build-and-deploy下的env配置，用${{ ... }}表达式语法引用变量并拼接成完整的镜像标签：

jobs:
  build-and-deploy:
    name: Build Docker image and Deploy to Cloud Run
    runs-on: ubuntu-latest
    env:
      IMAGE: gcr.io/${{ env.PROJECT_ID }}/${{ env.APP_NAME }}:${{ github.sha }}
    steps:
      # 后续步骤保持不变

注意：GITHUB_SHA属于GitHub上下文变量，需通过${{ github.sha }}引用，而非shell风格的$GITHUB_SHA。

方式二：通过shell命令设置环境变量 #

如果偏好shell风格的变量拼接，可以在工作流步骤中借助$GITHUB_ENV文件设置IMAGE变量：

jobs:
  build-and-deploy:
    name: Build Docker image and Deploy to Cloud Run
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository code
        uses: actions/checkout@v4

      # 添加此步骤设置IMAGE环境变量
      - name: Set image tag environment variable
        run: echo "IMAGE=gcr.io/$PROJECT_ID/$APP_NAME:$GITHUB_SHA" >> $GITHUB_ENV
      
      # 后续步骤保持不变，依然使用${{ env.IMAGE }}引用变量

这种方式下，shell会自动解析$PROJECT_ID、$GITHUB_SHA等环境变量，并将结果写入$GITHUB_ENV，让后续步骤可以正常使用${{ env.IMAGE }}。

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