Jenkins 版本选型（适配 Ubuntu 22.04 + GitLab CE 17.11.7）
一、Jenkins 版本选型（适配 Ubuntu 22.04 + GitLab CE 17.11.7） 首选版本：Jenkins 最新 LTS 长期支持版（截至 2026 年 3 月，推荐 2.462.3 LTS 及更新的 LTS 版本）[*]核心适配依据：
[*]GitLab 官方插件采用N-2 版本兼容策略，GitLab CE 17.11.7 属于 17.x 大版本，最新版 GitLab Plugin 可完全兼容，webhook 触发、API 交互、构建状态回传全功能支持。
[*]Ubuntu 22.04 LTS 是 Jenkins 官方一级支持的系统，LTS 版本稳定性强、插件生态适配完善，是生产环境的唯一推荐选择。
[*]最低兼容基线：Jenkins 2.401+（满足 GitLab Plugin 1.8.0 + 的依赖要求），不推荐非 LTS 的每周更新版，避免插件兼容问题。
[*]配套依赖强制要求：必须安装 OpenJDK 17 LTS（Jenkins 2.361.1+ 仅支持 Java 11/17，官方优先推荐 Java 17，Ubuntu 22.04 官方源可直接安装）。
二、Ubuntu 22.04 上 Jenkins 官方安装步骤
[*]系统更新与 Java 环境安装
bash 运行 # 更新系统软件源
sudo apt update && sudo apt upgrade -y
# 安装OpenJDK 17
sudo apt install -y openjdk-17-jdk
# 验证Java安装结果
java -version
[*]添加 Jenkins 官方源并安装
bash 运行 # 导入Jenkins官方GPG密钥，验证安装包完整性
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
# 添加LTS版本软件源
echo "deb https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
# 更新源并安装Jenkins
sudo apt update && sudo apt install -y jenkins
[*]服务启动与初始化
bash 运行 # 启动Jenkins并设置开机自启
sudo systemctl enable --now jenkins
# 查看服务运行状态（active (running) 即为启动成功）
sudo systemctl status jenkins
# 获取初始管理员密码
sudo cat /var/lib/jenkins/secrets/initialAdminPassword 浏览器访问 http://你的Jenkins服务器IP:8080，输入初始管理员密码，完成初始化（推荐直接安装推荐插件，已包含基础 Git 支持）。 三、Git Client 插件、GitLab 插件安装（2 种主流方式）
方式 1：Web 界面可视化安装（推荐，新手友好）
[*]前置准备：确保 Jenkins 服务器可访问外网，或已配置国内插件镜像源。
[*]分步安装：
[*]登录 Jenkins 后台，进入左侧菜单栏 系统管理 (Manage Jenkins) → 插件管理 (Plugins)。
[*]切换到 可选插件 (Available Plugins) 标签页，在搜索框分别搜索并勾选：
[*]Git Client：Git 核心客户端插件，是所有 Git 相关功能的基础依赖
[*]GitLab Plugin：GitLab 集成核心插件，实现 webhook 触发、API 交互、构建状态回传
[*]补充可选：Git Plugin（Git 操作增强，通常随 Git Client 自动依赖安装）
[*]勾选完成后，点击 安装后重启 (Install without restart)，等待安装完成，重启 Jenkins 服务生效。
[*]验证：安装完成后，在 已安装插件 (Installed Plugins) 中能看到对应插件，即为安装成功。
方式 2：命令行 CLI 安装（适合自动化 / 离线场景）
[*]终端执行安装命令（自动解决插件依赖）
bash 运行 # 一键安装Git Client插件 + GitLab插件
sudo jenkins-plugin-cli --plugins git-client gitlab-plugin
# 重启Jenkins使插件生效
sudo systemctl restart jenkins
[*]离线安装补充：若服务器无外网，可在Jenkins 官方插件市场下载对应插件的.hpi 文件，进入插件管理 → 高级 → 上传插件，手动上传安装。
四、确保 GitLab Webhook 交互正常的关键前置配置
[*]系统 Git 安装（Git Client 插件强依赖）
bash 运行 sudo apt install -y git
# 验证Git安装
git --version
[*]网络互通要求
[*]GitLab 服务器必须能访问 Jenkins 的 8080 端口（用于 webhook 事件推送）
[*]Jenkins 服务器必须能访问 GitLab 的 80/443 端口（用于拉取代码、API 调用）
[*]GitLab 内网 webhook 放行（内网环境必做） 使用 GitLab 管理员账号进入 Admin Area → Settings → Network → Outbound requests，勾选 Allow requests to the local network from webhooks and integrations，否则内网环境的 webhook 会被 GitLab 默认拦截。
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]