如何不借助Cloud Source Repositories部署Google Cloud Functions (v1)？

Cloud Functions v1 部署方案 #

方法1：gcloud命令行直接部署私有GitHub仓库代码 #

无需依赖Cloud Build，直接通过gcloud命令拉取私有GitHub仓库代码部署：

gcloud functions deploy YOUR_FUNCTION_NAME \
  --runtime python311 \ # 替换为你的运行时，比如nodejs20
  --trigger-http \
  --source https://github.com/USERNAME/REPO_NAME.git#BRANCH_NAME:SUBDIRECTORY_PATH \
  --region us-central1

私有仓库部署时，会提示输入GitHub用户名和密码，密码使用GitHub个人访问令牌（需开启repo权限）。

方法2：Cloud Build触发器自动化部署 #

1. 进入Cloud Build控制台，新建触发器，选择GitHub作为源代码仓库，完成授权并选择目标仓库和分支。
2. 配置构建配置，使用自定义cloudbuild.yaml，示例如下：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    args:
      - functions
      - deploy
      - YOUR_FUNCTION_NAME
      - --runtime=python311
      - --trigger-http
      - --source=SUBDIRECTORY_PATH # 若部署根目录则改为.
      - --region=us-central1

3. 确保Cloud Build服务账号（PROJECT_NUMBER@cloudbuild.gserviceaccount.com）拥有Cloud Functions Developer权限。

Cloud Functions v2 部署方案 #

v2控制台确实没有直接选择仓库的入口，推荐以下两种方式：

方法1：gcloud命令行部署 #

和v1类似，添加--gen2参数即可：

gcloud functions deploy YOUR_FUNCTION_NAME \
  --gen2 \
  --runtime python311 \
  --trigger-http \
  --source https://github.com/USERNAME/REPO_NAME.git#BRANCH_NAME:SUBDIRECTORY_PATH \
  --region us-central1

私有仓库同样使用GitHub个人访问令牌授权。

方法2：Cloud Build触发器自动化部署 #

同样通过Cloud Build连接GitHub，使用cloudbuild.yaml配置v2部署：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    args:
      - functions
      - deploy
      - YOUR_FUNCTION_NAME
      - --gen2
      - --runtime=python311
      - --trigger-http
      - --source=SUBDIRECTORY_PATH
      - --region=us-central1

v2默认使用Artifact Registry存储容器镜像，需确保Cloud Build服务账号拥有Artifact Registry Reader权限。

常见问题排查 #

• 权限错误：检查Cloud Build服务账号的权限，必要时添加Cloud Functions Admin或Editor权限进行测试（生产环境建议最小权限）。
• 私有仓库拉取失败：确认GitHub个人访问令牌的权限范围，确保包含repo权限，且令牌未过期。
• 子目录路径无效：分支和子目录的格式为#BRANCH:SUBDIRECTORY，例如#main:functions/payment，确保路径不存在拼写错误。

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