如何将Google Source Repository与Dataform环境成功连接？

为什么你之前的SSH方法失败？ #

Google Source Repository（GSR）的SSH认证机制和Dataform的SSH配置不兼容，Dataform针对GSR的官方推荐方式是使用Google Cloud服务账号密钥完成认证，而非普通SSH密钥或个人访问令牌。

具体操作步骤 #

1. 创建并配置Cloud服务账号

   • 登录GCP控制台，进入「IAM与管理员」>「服务账号」页面
   • 点击「创建服务账号」，填写名称和描述后完成创建
   • 为该服务账号添加对应角色（按需选择）：
     • 仅需读取仓库：Source Repository Reader
     • 需要读写仓库：Source Repository Writer 或 Source Repository Owner
   • 建议直接在Dataform所在的GCP项目下创建服务账号，避免跨项目权限问题

2. 生成服务账号JSON密钥

   • 进入刚创建的服务账号详情页，切换到「密钥」标签
   • 点击「添加密钥」>「创建新密钥」，选择「JSON」格式
   • 将生成的JSON密钥文件下载到本地并妥善保存

3. 在Dataform中配置Git连接

   • 打开Dataform控制台，进入目标环境，点击顶部导航的「Git」选项
   • 在Git提供商选择界面，选择「Google Cloud Source Repositories」
   • 填入你的GSR仓库完整URL（格式示例：https://source.developers.google.com/p/[你的GCP项目ID]/r/[你的仓库名称]）
   • 点击「上传密钥文件」，选择刚才下载的服务账号JSON密钥文件
   • 完成配置后点击「测试连接」，验证是否成功

常见问题排查 #

• 若仍提示连接失败，检查服务账号的角色是否正确配置，确保权限覆盖目标仓库
• 确认Dataform环境所在GCP项目与GSR所在项目一致，或已配置跨项目访问权限
• 检查JSON密钥文件是否完整，未被修改或损坏

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