如何向Cloud Run实例传递分支与commit构建版本信息？

你可以直接利用Cloud Build的内置能力，在构建部署流程中把Git、构建相关元信息传递到Cloud Run实例中，不需要额外对接Git平台API，所有信息在触发构建时就已经可获取。

1. 直接使用Cloud Build内置的Git触发变量 #

当Cloud Build触发器绑定Git仓库的推送事件时，会自动注入以下可直接在构建流程中使用的替换变量，不需要手动配置参数传递：

• $COMMIT_SHA：触发本次构建的完整Git commit哈希值
• $SHORT_SHA：短格式commit哈希（通常为前7位，适合做版本号展示）
• $BRANCH_NAME：触发本次构建的Git分支名称
• $REPO_NAME：绑定的Git仓库名称
• $BUILD_ID：Cloud Build本次构建任务的唯一标识
• $PROJECT_ID：当前所属的GCP项目ID

2. 选择适配你项目的注入方式 #

根据你的应用技术栈，选以下任意一种方式把变量传入运行中的Cloud Run实例即可：

方式1：构建时写入镜像内静态文件（全语言通用） #

在镜像构建步骤前新增一个步骤，把上述变量值写入代码目录下的固定文件（比如build-info.json），后续构建镜像时会自动把该文件打包进容器，应用运行时直接读取该文件就能拿到所有信息。
cloudbuild.yaml 对应配置示例：

steps:
  # 写入构建信息到静态文件
  - name: 'bash'
    args:
      - '-c'
      - |
        cat > build-info.json << EOF
        {
          "branch": "$BRANCH_NAME",
          "commitSha": "$COMMIT_SHA",
          "shortSha": "$SHORT_SHA",
          "repoName": "$REPO_NAME",
          "buildId": "$BUILD_ID"
        }
        EOF
  # 原有镜像构建步骤
  - name: 'gcr.io/cloud-builders/docker'
    args: ['build', '-t', 'gcr.io/$PROJECT_ID/your-service-name:$COMMIT_SHA', '.']
  # 原有镜像推送到Artifact Registry/Container Registry步骤
  # 原有Cloud Run部署步骤

注意确认.dockerignore文件没有排除你写入的这个静态文件，否则文件不会被打进镜像。

方式2：部署时设置Cloud Run环境变量（无侵入，不用改镜像构建逻辑） #

如果你不想修改镜像构建流程，可以直接在Cloud Run部署步骤中，把上述变量设置为Cloud Run服务的环境变量，应用运行时直接读取进程环境变量即可拿到信息，配置更轻量。
cloudbuild.yaml 对应部署步骤示例：

steps:
  # 原有镜像构建、推送步骤
  # 部署到Cloud Run时注入环境变量
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: gcloud
    args:
      - 'run'
      - 'deploy'
      - 'your-cloud-run-service-name'
      - '--image'
      - 'gcr.io/$PROJECT_ID/your-service-name:$COMMIT_SHA'
      - '--region'
      - 'your-deploy-region'
      - '--set-env-vars'
      - 'BUILD_BRANCH=$BRANCH_NAME,BUILD_COMMIT_SHA=$COMMIT_SHA,BUILD_SHORT_SHA=$SHORT_SHA,BUILD_REPO=$REPO_NAME,BUILD_ID=$BUILD_ID'

不同语言读取环境变量的方式都是原生能力，比如Node.js用process.env.BUILD_COMMIT_SHA、Python用os.getenv("BUILD_BRANCH")即可，不需要额外引入依赖。

3. 注意事项 #

• 上述传递的信息都是非敏感的版本元信息，不要通过这两个渠道传递密钥、账号类敏感配置，敏感配置请用Cloud Run的Secret Manager挂载能力。
• 如果是手动触发Cloud Build、或者非Git事件触发的构建，上述Git相关变量默认是空值，这类场景可以在手动触发构建时手动填写对应替换变量的值即可。
• 如果用Cloud Buildpacks做无Dockerfile构建，优先选环境变量注入的方式，不需要调整构建逻辑。

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