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
永久关闭)。
声明:本文内容由网友自发贡献,本站不承担相应法律责任。对本内容有异议或投诉,请联系2913721942#qq.com核实处理,我们将尽快回复您,谢谢合作!
若转载请注明出处: Jenkins在CentOS上的配置方法
本文地址: https://pptw.com/jishu/717726.html