概述
直接切入主题。在 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 https://jenkins-ci.org/redhat/jenkins.repo
$ sudo rpm --import https://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 环境便搭建完成。
