CentOS 7 安装 Jenkins 详细教程

概述

直接切入主题。在 CentOS 7 上部署 Jenkins 的流程并不复杂，但如果忽略了某些关键配置，后续排查故障会非常棘手。以下按顺序讲解。

安装 Java

Jenkins 依赖 Java 环境，首先需要安装 JDK。请注意版本兼容性：较新版本的 Jenkins 对 Java 11 及以上支持更佳，但 CentOS 7 默认仓库仅提供 Java 8。若使用新版 Jenkins，建议手动安装 Java 11。不过此处先按经典方式操作：

$ sudo yum install -y java......

这样会安装 OpenJDK，足以满足日常使用。安装完成后建议检查版本，确保环境能够正常调用。

安装 Jenkins

Jenkins 官方提供了 yum 仓库，直接添加源然后安装即可，非常便捷。

$ sudo wget -O /etc/yum.repos.d/jenkins.repo http://jenkins-ci.org/redhat/jenkins.repo  
$ sudo rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key  
$ sudo yum install -y jenkins......

需要特别留意的是：官方源可能因网络问题偶尔连接超时。若下载失败，可尝试更换国内镜像源，或手动下载 RPM 包后进行本地安装。

配置

安装完成后，Jenkins 的默认路径如下：

• 主目录：/var/lib/jenkins/
• 配置文件：/etc/sysconfig/jenkins

配置文件中有三个参数需要重点关注：

• JENKINS_HOME：Jenkins 的工作目录，插件、构建产物等全部存储于此。若磁盘空间不足，建议将该目录挂载到独立分区。
• JENKINS_USER：运行 Jenkins 的系统用户，默认为 jenkins。该用户必须拥有 $JENKINS_HOME 和 /var/log/jenkins 的读写权限。
• JENKINS_PORT：监听端口，默认 8080。生产环境中建议更换为不常用端口，以避免与其他服务冲突，并提升安全性。

另外补充一点：JENKINS_HOME 目录不仅仅是存放配置文件的，插件、构建历史、凭据等全部容纳其中。如果 Jenkins 发生故障，只要该目录完好，在新机器上重新安装 Jenkins 并将目录覆盖回去，基本就能恢复原状。

授权

实际使用中，Jenkins 经常需要操作其他系统资源，例如使用 docker 命令构建镜像。此时 jenkins 用户必须拥有相应权限。最直接的方法是将其加入 docker 用户组：

$ sudo usermod -a -G docker jenkins

添加用户组后，务必重启 Jenkins 或使该用户重新登录，否则组权限不会立即生效。同理，如果 Jenkins 需要操作 /var/run/docker.sock，也要确保权限配置到位。

启动 Jenkins

所有配置就绪后，设置开机自启并启动服务：

$ systemctl enable jenkins   # 开机启动  
$ systemctl start jenkins    # 启动jenkins

启动后可通过 systemctl status jenkins 查看状态。首次访问 Jenkins 页面时，需在日志中获取初始管理员密码，该密码位于 /var/lib/jenkins/secrets/initialAdminPassword，复制出来填入即可。之后按引导安装插件、创建用户，一套流程走完，一个可用的 CI/CD 环境便搭建完成。