Jenkins 2.373迁移至Ubuntu虚拟机后任务执行失败问题咨询

1. 系统依赖缺失 #

Ubuntu与CentOS的基础工具链差异显著，构建后期失败多因缺少关键依赖：

• 先查看构建日志的具体错误，定位是否有command not found类提示（比如gcc、make、特定语言运行时）
• 对照旧CentOS机器的已安装包列表，在Ubuntu上安装对应工具：
  • 若为Java项目，确保Ubuntu上JDK版本与旧机器完全一致，可通过update-alternatives --config java切换版本
  • 涉及容器构建的话，安装Docker并将Jenkins用户加入docker组：

    sudo apt install docker.io docker-compose
    sudo usermod -aG docker jenkins
    sudo systemctl restart jenkins
    

2. 文件权限异常 #

CentOS与Ubuntu的Jenkins用户UID/GID可能不一致，导致目录权限冲突：

• 分别在新旧机器执行id jenkins对比UID/GID，若不一致则修改新机器的Jenkins用户ID：

  sudo usermod -u <旧CentOS的JenkinsUID> jenkins
  sudo groupmod -g <旧CentOS的JenkinsGID> jenkins
  sudo chown -R jenkins:jenkins /mnt/storage/lib/jenkins /var/lib/jenkins
  

• 检查构建工作目录（如/var/lib/jenkins/workspace）的权限，确保Jenkins用户拥有读写执行权限

3. 环境变量未同步 #

旧CentOS的系统级或Jenkins全局环境变量未迁移到Ubuntu：

• 导出旧机器/etc/profile、/etc/bashrc的环境变量，在Ubuntu对应文件中补充
• 登录Jenkins后台，检查「系统管理->全局工具配置」里的JAVA_HOME、MAVEN_HOME等路径是否与旧机器一致

4. BitBucket并发冲突 #

新旧Jenkins同时连接同一BitBucket仓库可能引发拉取、Webhook冲突：

• 临时停止旧Jenkins服务，测试新机器构建是否能完成，验证是否为并发问题
• 在BitBucket后台更新Webhook地址为新Jenkins的地址，移除旧地址
• 重新配置新Jenkins的BitBucket凭证，确保权限有效

5. 插件兼容性问题 #

部分插件在Ubuntu环境下可能存在隐性兼容问题：

• 查看Jenkins日志（/var/log/jenkins/jenkins.log），定位插件报错信息，针对性更新或重装插件
• 重点排查系统级插件（如SSH Agent、Docker Pipeline）的版本与Ubuntu系统的兼容性

额外备份与配置建议 #

• 备份旧CentOS的/etc/sysconfig/jenkins，对照配置新Ubuntu的/etc/default/jenkins，确保JVM参数（如内存分配-Xmx、-Xms）与旧机器一致
• 导出旧机器的全局工具配置（Git、Maven等安装路径），在新机器同步配置

内容的提问来源于stack exchange，提问作者Delaram Hamraz