GCP Cloud Build触发器连接GitLab仓库构建失败问题求助

我之前也碰到过几乎一模一样的问题，结合你的描述和Cloud Build的运行机制，几个核心点可能导致/root/.ssh/id_rsa文件没被正确创建：

1. 检查SSH密钥的格式与存储有效性 #

首先确认存在Secret Manager中的SSH私钥是完整且未加密的：

• 必须包含完整的头部-----BEGIN RSA PRIVATE KEY-----和尾部-----END RSA PRIVATE KEY-----
• 私钥内容不能有多余的换行、空格或格式错乱
• 绝对不能使用带密码保护的私钥（Cloud Build无法自动解密带密码的密钥）

2. 给Cloud Build服务账号添加上密钥读取权限 #

Cloud Build的默认服务账号需要具备读取Secret Manager密钥的权限，不然即使配置了路径也拿不到密钥：

• 打开Google Cloud Console的IAM页面，找到格式为[你的项目编号]@cloudbuild.gserviceaccount.com的Cloud Build服务账号
• 为该账号添加Secret Manager Secret Accessor角色
• 保存权限后重新触发构建测试

3. 调整YAML中的SSH配置逻辑 #

你的初始YAML可能缺少对.ssh目录的初始化步骤，或者权限设置有遗漏。试试这个修正后的版本：

steps:
# 1. 初始化SSH环境并加载密钥
- name: gcr.io/cloud-builders/git
  args:
  - '-c'
  - |
    # 先创建.ssh目录并设置基础权限
    mkdir -p /root/.ssh
    chmod 700 /root/.ssh
    # 写入SSH私钥并设置严格权限（必须是400）
    echo "$$SSHKEY" > /root/.ssh/id_rsa
    chmod 400 /root/.ssh/id_rsa
    # 添加GitLab到已知主机列表
    ssh-keyscan gitlab.com >> /root/.ssh/known_hosts
    chmod 644 /root/.ssh/known_hosts
  entrypoint: bash
  secretEnv:
  - SSHKEY
  volumes:
  - name: ssh
    path: /root/.ssh

# 2. 克隆GitLab仓库（注意URL格式：git@gitlab.com:用户名/仓库名.git）
- name: gcr.io/cloud-builders/git
  args:
  - clone
  - '-n'
  - 'git@gitlab.com:YOUR_USERNAME/YOUR_REPO.git'
  - .
  volumes:
  - name: ssh
    path: /root/.ssh

# 3. 切换到触发构建的目标提交
- name: gcr.io/cloud-builders/git
  args:
  - checkout
  - $_TO_SHA
  volumes:
  - name: ssh
    path: /root/.ssh

# 4. 这里添加你的Docker镜像构建步骤（示例）
- name: gcr.io/cloud-builders/docker
  args:
  - build
  - '-t'
  - 'gcr.io/[你的项目ID]/[镜像名]:$COMMIT_SHA'
  - .

availableSecrets:
  secretManager:
  - versionName: projects/[你的项目ID]/secrets/[密钥名]/versions/latest
    env: SSHKEY

4. 修正Git克隆URL的格式 #

GitLab的SSH克隆URL必须用冒号分隔主机和仓库路径，你的原YAML里写的git@gitlab.com/GITLAB_REPO是错误格式，正确格式应该是git@gitlab.com:用户名/仓库名.git。

5. 利用构建日志排查细节 #

如果还是失败，一定要查看Cloud Build的详细构建日志：

• 定位到第一个SSH配置步骤的日志，检查echo "$$SSHKEY"是否有执行错误
• 可以临时在脚本里加一行cat /root/.ssh/id_rsa，验证密钥是否被正确写入（测试完记得删掉这行）

内容的提问来源于stack exchange，提问作者Shubham Singh Rana