Cloud Build无法触发GitLab EE构建 求助排查

一、修复GitLab仓库URL格式问题 #

• 确保触发器配置中的GitLab仓库URL为标准HTTPS格式，示例：https://your-gitlab-ee-domain/group/subgroup/project.git
  • 禁止使用SSH格式（如git@your-gitlab-ee-domain:group/project.git），Cloud Build解析SSH URL时会触发字符串匹配错误
  • 检查URL是否包含多余字符（空格、特殊符号），结尾必须带.git后缀
• 若GitLab EE使用自定义端口，URL需明确包含端口号，示例：https://gitlab.example.com:8443/group/project.git

二、验证个人访问令牌权限与有效性 #

• 除已配置的api、read_api、read_repository权限，需添加repo权限（GitLab 14.x版本中读取仓库提交依赖该权限）
• 重新生成令牌并重新配置Cloud Build的GitLab连接，避免令牌过期或配置时输入错误
• 进入GitLab项目「设置」→「通用」→「可见性、项目功能、权限」，确认「仓库」功能已启用，且项目可见性设置允许令牌持有者访问

三、修正Cloud Build触发器与cloudbuild.yaml配置 #

• 手动触发时，必须指定GitLab仓库中存在的有效分支或标签名称
• 修改cloudbuild.yaml中的镜像推送地址，asia-docker.pkg.dev与asia.gcr.io不可同时使用，二选一即可；同时兼容分支与标签触发的标签变量：

  steps:
    - name: 'gcr.io/kaniko-project/executor:latest'
      args:
        - '--cache=true'
        - '--dockerfile=docker/alpine/Dockerfile'
        - '--destination=asia-docker.pkg.dev/$PROJECT_ID/${_ARTIFACT_REGISTRY}/xxx-api:${TAG_NAME:-$BRANCH_NAME}'
        - '--target=xxx-api'
        - '--context=dir://.'
  substitutions:
    _ARTIFACT_REGISTRY: xxx-api-dev
  

  • 使用${TAG_NAME:-$BRANCH_NAME}确保分支推送时自动用分支名作为镜像标签，避免标签为空引发异常

四、检查版本兼容性与网络连通性 #

GitLab EE 14.10.x为较旧版本，需确认：

• GitLab EE的API服务正常，可通过访问https://your-gitlab-ee-domain/api/v4/projects/your-project-id验证（请求头携带个人访问令牌的Authorization字段）
• 若GitLab EE配置了防火墙或代理，需允许Cloud Build的IP地址访问GitLab服务

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