如何通过Python SDK在Google Cloud源代码仓库创建新分支？

权限配置 #

首先要确保core服务的运行身份（比如Cloud Run/Cloud Functions的服务账号、GCE实例的服务账号）拥有操作clients仓库的权限：

• 进入Google Cloud控制台，找到clients对应的Cloud Source Repository
• 给core服务使用的服务账号添加Source Repository Writer（roles/source.repos.writer）角色

利用Cloud Source Repositories API创建分支 #

你找到的官方文档核心是通过REST API操作代码仓库，以下是关键内容的中文翻译及实操步骤：

Cloud Source Repositories提供的projects.repos.createRef API方法可用于创建新分支，本质是基于已有分支（比如main分支）生成新的引用。

API调用参数说明

• 父资源路径：格式为projects/{项目ID}/repos/{仓库名称}
• 请求体：需指定ref（新分支的完整引用路径，格式为refs/heads/{客户名称}）和revision（作为分支基础的原分支或提交哈希，比如refs/heads/main）

代码示例（Python）

如果你的core服务用Python编写，可借助Google Auth库和Requests库实现API调用：

import requests
from google.oauth2 import service_account

# 替换为你的项目ID、clients仓库名、客户名称
PROJECT_ID = "your-project-id"
REPO_NAME = "clients"
CLIENT_NAME = "customer-x"

# 服务账号凭据（在GCP托管环境运行可省略，自动使用应用默认凭据）
credentials = service_account.Credentials.from_service_account_file(
    "path/to/service-account-key.json",
    scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
access_token = credentials.token

# API请求URL
url = f"https://sourcerepo.googleapis.com/v1/projects/{PROJECT_ID}/repos/{REPO_NAME}/refs"

# 请求体
payload = {
    "ref": f"refs/heads/{CLIENT_NAME}",
    "revision": "refs/heads/main"  # 基于main分支创建新分支
}

# 发送POST请求
response = requests.post(
    url,
    json=payload,
    headers={"Authorization": f"Bearer {access_token}"}
)

if response.status_code == 200:
    print(f"成功创建分支 {CLIENT_NAME}")
else:
    print(f"创建失败: {response.text}")

备选方案：使用gcloud命令行

如果core的部署流程可调用gcloud命令，也能通过以下命令创建分支：

gcloud source repos create-ref clients \
    --ref=refs/heads/{客户名称} \
    --source-ref=refs/heads/main \
    --project=your-project-id

注意要确保运行命令的身份已配置好权限，且gcloud已完成初始化。

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