如何在GCP部署时为指定Cloud Function绑定Git Commit SHA

以下几种方法可以实现为指定Cloud Function单独设置专属变量或标记，不会影响其他函数：

方法1：部署前在函数代码中注入SHA常量 #

直接在函数代码里动态注入Commit SHA，无需依赖环境变量：

1. 在函数代码中预留占位符：

// functions/function1.js
const COMMIT_SHA = '__COMMIT_SHA__';

exports.function1 = functions.https.onRequest((req, res) => {
  res.send(`当前版本Commit: ${COMMIT_SHA}`);
});

2. 部署前替换占位符并部署目标函数：

# 替换占位符为当前Git SHA
sed -i "s/__COMMIT_SHA__/$(git rev-parse HEAD)/g" functions/function1.js
# 仅部署目标函数
firebase deploy --only functions:function1

优点：无需依赖环境变量配置，运行时直接读取常量；缺点：代码会被临时修改，需确保不会提交修改后的代码到仓库。

方法2：通过函数级Runtime Options注入环境变量 #

利用Firebase Functions的runWith配置，为单个函数单独指定环境变量，部署时临时传入SHA：

1. 在函数定义中配置runtimeOptions：

// functions/index.js
const functions = require("firebase-functions");

exports.function1 = functions
  .runWith({
    env: {
      COMMIT_SHA: process.env.COMMIT_SHA
    }
  })
  .https.onRequest((req, res) => {
    res.send(`Commit SHA: ${process.env.COMMIT_SHA}`);
  });

// 其他函数不受此配置影响
exports.function2 = functions.https.onRequest((req, res) => {
  res.send("其他函数");
});

2. 部署时临时传入环境变量，仅对当前部署命令生效：

COMMIT_SHA=$(git rev-parse HEAD) firebase deploy --only functions:function1

优点：无需修改函数核心逻辑，仅针对目标函数生效；缺点：需确保部署环境能读取到临时环境变量。

方法3：使用gcloud命令直接部署单个函数并设置环境变量 #

跳过Firebase CLI，直接用gcloud命令部署目标函数，可单独指定专属环境变量：

gcloud functions deploy function1 \
  --runtime nodejs18 \ # 替换为你的函数运行时
  --trigger-http \ # 替换为你的函数触发器类型
  --set-env-vars COMMIT_SHA=$(git rev-parse HEAD) \
  --project your-project-id # 替换为你的项目ID

优点：GCP原生支持，配置灵活，可单独设置任意专属变量；缺点：需要熟悉gcloud命令的参数配置。

方法4：为函数添加专属标签（非运行时访问） #

如果不需要在函数运行时读取SHA，仅用于资源标记和版本追踪，可给单个函数添加标签：

gcloud functions deploy function1 \
  --runtime nodejs18 \
  --trigger-http \
  --labels commit_sha=$(git rev-parse HEAD) \
  --project your-project-id

之后可通过GCP控制台查看函数标签，或用命令查询：

gcloud functions describe function1 --project your-project-id | grep labels

优点：不影响函数运行时逻辑，仅用于资源元数据标记；缺点：无法在函数代码中直接读取标签内容。

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