1. 配置前的准备工作
在开始配置前,请确保您已具备以下条件:
- 已安装并运行 Jenkins 和 GitLab
- 拥有 GitLab 管理员权限
- 了解基本的 Jenkins 和 GitLab 操作
2. 安装必要的 Jenkins 插件
2.1 安装 GitLab 插件
- 登录 Jenkins 管理界面
- 进入 系统管理 > 插件管理 > 可用插件
- 搜索并安装以下插件:
- GitLab Plugin(核心插件)
- Git plugin(Git 集成)
- Build Authorization Token Root Plugin(Webhook 认证)
2.2 插件配置检查
安装完成后,重启 Jenkins 服务确保插件生效:
sudo systemctl restart jenkins
3. 在 GitLab 中创建访问令牌
3.1 创建 Personal Access Token
- 登录 GitLab,进入 Settings > Access Tokens
- 创建新令牌,配置以下权限:
api(完全 API 访问)read_repository(读取仓库)write_repository(写入仓库)
- 保存生成的令牌(稍后在 Jenkins 中需要使用)
3.2 创建 Project Access Token(推荐用于项目级集成)
对于更安全的项目级集成,建议使用项目访问令牌:
- 进入具体项目 Settings > Access Tokens
- 创建令牌并选择所需权限
4. 在 Jenkins 中配置 GitLab 连接
4.1 添加 GitLab 服务器配置
- 进入 系统管理 > 系统配置
- 找到 GitLab 部分,配置如下:
GitLab 连接名称:gitlab-server
GitLab 主机 URL: https://your-gitlab-domain.com
凭据:选择或添加 GitLab 访问令牌
4.2 配置凭据
- 点击 添加 > Jenkins
- 选择 GitLab API token 类型
- 输入在 GitLab 中创建的访问令牌
- ID 可留空,系统会自动生成

