Jenkins在CentOS上的配置方法

Jenkins在CentOS上的配置方法

1. 安装前准备

1.1 更新系统

运行sudo yum update -y更新系统软件包，确保系统环境稳定。

1.2 安装Java环境

Jenkins基于Java开发，需先安装JDK 1.8或更高版本（推荐OpenJDK 11+）。
执行sudo yum install -y java-11-openjdk-devel安装OpenJDK 11，安装完成后通过java -version验证是否成功（需显示Java版本信息）。

2. 安装Jenkins

2.1 添加Jenkins官方仓库

• 下载Jenkins仓库配置文件：sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
• 导入Jenkins官方GPG密钥：sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
  以上步骤确保能从官方源安全下载Jenkins。

2.2 安装Jenkins

运行sudo yum install -y jenkins通过YUM包管理器安装Jenkins，安装过程会自动解决依赖问题。

3. 配置Jenkins

3.1 修改Jenkins配置文件

编辑/etc/sysconfig/jenkins文件（部分系统为/etc/default/jenkins），调整以下关键参数：

• 端口设置：修改JENKINS_PORT（默认8080，若8080被占用可改为8090或其他端口）；
• 用户权限：建议将JENKINS_USER设置为jenkins（默认用户，避免使用root）；
• 数据目录：确认JENKINS_HOME（默认/var/lib/jenkins，存储Jenkins所有数据）。
  修改后保存文件。

3.2 设置目录权限

确保Jenkins用户对数据目录有读写权限，执行：
sudo chown -R jenkins:jenkins /var/lib/jenkins /var/cache/jenkins /var/log/jenkins
避免因权限问题导致Jenkins无法启动。

4. 启动Jenkins服务

4.1 启动与开机自启

• 启动Jenkins服务：sudo systemctl start jenkins
• 设置开机自启：sudo systemctl enable jenkins
  确保系统重启后Jenkins自动运行。

4.2 检查服务状态

运行sudo systemctl status jenkins，若显示“active (running)”则表示服务启动成功。

5. 配置防火墙

若系统启用了firewalld，需开放Jenkins端口（默认8080）：
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
确保外部能访问Jenkins Web界面。

6. 初始化Jenkins

6.1 获取初始管理员密码

运行sudo cat /var/lib/jenkins/secrets/initialAdminPassword，复制输出的密码（用于首次解锁）。

6.2 完成Web初始化

• 在浏览器中访问http://<服务器IP>:8080（若修改了端口，替换为对应端口）；
• 输入初始密码解锁；
• 选择“安装推荐插件”（快速搭建基础环境）或“自定义安装”（按需选择插件）；
• 创建管理员账号（设置用户名、密码），完成初始化。

7. 后续配置（可选但推荐）

7.1 安装必要插件

进入“系统管理”→“插件管理”，安装以下常用插件：

• Git：用于源码管理；
• Maven/Gradle：用于Java项目构建；
• Pipeline：用于定义自动化流程；
• Blue Ocean：美化界面，提升可视化体验。

7.2 配置全局工具

进入“系统管理”→“全局工具配置”，设置以下工具路径：

• JDK：指定JDK安装路径（如/usr/lib/jvm/java-11-openjdk）；
• Git：指定Git安装路径（如/usr/bin/git）；
• Maven：指定Maven安装路径（如/usr/local/maven）。
  避免每次构建时手动指定工具路径。

7.3 配置SSH访问（可选）

若需通过SSH远程访问Jenkins或连接Git仓库：

• 安装OpenSSH服务器：sudo yum install -y openssh-server；
• 启动SSH服务：sudo systemctl start sshd；
• 设置开机自启：sudo systemctl enable sshd；
• 创建Jenkins专用用户：sudo adduser jenkins，并设置密码；
• 修改SSH配置（/etc/ssh/sshd_config），添加AllowUsers jenkins，限制访问用户；
• 重启SSH服务：sudo systemctl restart sshd。

常见问题解决

• Jenkins无法启动：检查/var/log/jenkins/jenkins.log日志，常见原因包括端口冲突、Java路径错误、权限不足；
• 无法访问Web界面：确认防火墙是否开放端口，或SELinux是否禁用（sudo setenforce 0临时关闭，/etc/selinux/config中设置SELINUX=disabled永久关闭）。