GitLab如何与其他工具集成

集成总览与方式

• 内置项目服务集成：在项目的 Settings > Integrations 中启用并配置 Jenkins CI、Slack notifications、Slack slash commands、JIRA 等，适合开箱即用的事件通知与联动。
• Webhooks：为项目或系统事件配置 Webhooks，向外部系统推送 HTTP POST 通知，外部服务据此执行动作（如构建、部署、同步）。
• GitLab API：使用 Personal Access Token 或 OAuth2 调用 REST API v4 做自动化（创建项目、管理合并请求、用户与权限等）。
• 身份与单点登录：通过 LDAP、SAML、OAuth2、OpenID Connect、Kerberos 等统一认证，集中账号管理与访问控制。
• 自托管与外部证书：对接自签名证书服务时，需将根证书加入 操作系统信任链 或 GitLab Omnibus 信任证书，避免 SSL 校验错误。

与 Jenkins 集成

• GitLab 触发 Jenkins 构建：在 Jenkins 安装 GitLab Plugin，创建 API Token 并在 Manage Jenkins > Configure System 配置 GitLab 连接；在 项目配置 勾选 Build when a change is pushed to GitLab，并选择 Accepted Merge Request Events、Closed Merge Request Events 等触发；在 GitLab 项目 > Settings > Integrations > Jenkins CI 填入 Jenkins 地址、项目名、凭证，保存并 Test settings。
• Jenkins 回写构建状态：在 Freestyle 项目的 Post-build Actions 勾选 Publish build status to GitLab；在 Pipeline 中使用脚本步骤 updateGitlabCommitStatus 更新状态。
• 本地开发网络放行：当 Jenkins 运行在本机时，需在 Admin Area > Settings > Network > Outbound requests 勾选 Allow requests to the local network from web hooks and services，否则 GitLab 无法回调本机。
• 安全建议：为 Webhook 配置 Secret Token，并在需要时临时关闭 SSL verification（仅测试环境）。

与 Slack 集成

• 事件通知到频道：在 Slack 创建 Incoming Webhooks，获取 Webhook URL；在 GitLab 项目 > Settings > Integrations > Slack notifications 填入 URL、选择频道与事件，点击 Test settings and save changes，即可在提交、合并请求、流水线等事件发生时推送通知。
• Slash Commands：在 GitLab 项目 > Settings > Integrations > Slack slash commands 获取回调 URL，在 Slack 的 Slash Commands 集成页面填写并保存，复制 Token 回填到 GitLab，启用后可在 Slack 中使用如 /gitlab 等命令操作 GitLab 内容。
• GitLab.com 使用建议：对于 GitLab.com，优先使用官方的 GitLab Slack app 替代传统 Webhooks/Slash Commands。

与 JIRA 及外部工单系统集成

• JIRA 集成方式：在 GitLab 可对接 JIRA 作为外部工单系统，实现 提交信息、合并请求与 JIRA 问题的双向关联；可在项目级集成中配置 JIRA 服务，或使用 JIRA 提供的 GitLab 插件 在 JIRA 内查看相关代码活动。
• 典型用法：在提交信息或 MR 描述中写入 JIRA 问题 Key（如 PROJ-123），GitLab 会在对应 JIRA 问题 下展示相关提交与 MR 链接，便于跨工具追踪需求与缺陷。

API 与 Webhooks 实践及证书问题

• 调用 GitLab API：在 用户设置 > Access Tokens 生成 Personal Access Token，以 Private-Token 请求头调用 API v4（如获取项目列表、创建 MR、管理 Runner 等）。
• 配置 Webhooks：在项目 Settings > Webhooks 添加目标 URL 与触发事件，选择 Push events、Merge request events、Pipeline events 等；为提升安全性，使用 Secret Token 并在服务端校验。
• 自签名证书处理：对接使用自签名证书的内部服务时，将根证书加入 操作系统信任链，或在 Omnibus 安装中将证书追加到 /opt/gitlab/embedded/ssl/certs/cacert.pem，然后执行 sudo gitlab-ctl restart 使信任生效。