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 运行    

1. # 更新系统软件源
2. sudo apt update && sudo apt upgrade -y
3. # 安装OpenJDK 17
4. sudo apt install -y openjdk-17-jdk
5. # 验证Java安装结果
6. java -version

复制代码

• 添加 Jenkins 官方源并安装
  

 bash 运行    

1. # 导入Jenkins官方GPG密钥，验证安装包完整性
2. curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
3. # 添加LTS版本软件源
4. echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
5. # 更新源并安装Jenkins
6. sudo apt update && sudo apt install -y jenkins

复制代码

  

• 服务启动与初始化
  

 bash 运行    

1. # 启动Jenkins并设置开机自启
2. sudo systemctl enable --now jenkins
3. # 查看服务运行状态（active (running) 即为启动成功）
4. sudo systemctl status jenkins
5. # 获取初始管理员密码
6. 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 运行    

1. # 一键安装Git Client插件 + GitLab插件
2. sudo jenkins-plugin-cli --plugins git-client gitlab-plugin
3. # 重启Jenkins使插件生效
4. sudo systemctl restart jenkins

复制代码

  

• 离线安装补充：若服务器无外网，可在Jenkins 官方插件市场下载对应插件的.hpi 文件，进入插件管理 → 高级 → 上传插件，手动上传安装。
  

  四、确保 GitLab Webhook 交互正常的关键前置配置

 

• 系统 Git 安装（Git Client 插件强依赖）
  

 bash 运行    

1. sudo apt install -y git
2. # 验证Git安装
3. 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 默认拦截。
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！