centos上jenkins部署教程

CentOS上Jenkins部署详细教程

一、环境准备

1. 更新系统

确保系统软件包为最新版本，避免兼容性问题：

sudo yum update -y

2. 安装Java环境

Jenkins基于Java开发，需安装Java运行时环境（推荐OpenJDK 8或11）：

sudo yum install java-1.8.0-openjdk-devel -y  # OpenJDK 8
# 或
sudo yum install java-11-openjdk-devel -y    # OpenJDK 11

验证安装是否成功：

java -version

输出应包含Java版本信息（如openjdk version "1.8.0_392"）。

二、安装Jenkins

1. 添加Jenkins官方YUM仓库

sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

2. 安装Jenkins

通过YUM包管理器安装Jenkins（自动解决依赖）：

sudo yum install jenkins -y

三、启动与配置Jenkins服务

1. 启动Jenkins并设置开机自启

sudo systemctl start jenkins      # 启动服务
sudo systemctl enable jenkins     # 设置开机自启

2. 配置防火墙（允许外部访问）

Jenkins默认使用8080端口，需开放该端口：

sudo firewall-cmd --permanent --add-service=http  # 开放HTTP服务（默认80端口，若修改Jenkins端口需对应调整）
sudo firewall-cmd --reload                        # 重新加载防火墙规则

若使用自定义端口（如9999），需修改端口配置并重新开放：

sudo vim /etc/sysconfig/jenkins  # 编辑配置文件
# 找到`JENKINS_PORT="8080"`，修改为`JENKINS_PORT="9999"`
sudo firewall-cmd --permanent --add-port=9999/tcp  # 开放自定义端口
sudo firewall-cmd --reload

四、初始化Jenkins

1. 获取初始管理员密码

首次访问需输入初始密码，该密码位于Jenkins数据目录：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

复制输出的密码（如599ad742855948e0b8af280ad2e1f09f）。

2. 访问Jenkins Web界面

在浏览器中输入服务器IP及端口（默认8080，若修改则替换为自定义端口）：

http://<
    your_server_ip>
    :8080

粘贴初始密码，点击Continue（继续）。

3. 安装推荐插件

选择“Install suggested plugins”（安装推荐插件），Jenkins会自动安装Git、Maven、Pipeline等常用插件（约10-20分钟，取决于网络速度）。

4. 创建管理员用户

填写用户名、密码、全名及邮箱（如admin/Admin@123456），点击Save and Finish（保存并完成）。

5. 完成初始设置

点击Start using Jenkins（开始使用Jenkins），进入Jenkins主界面。

五、后续配置（可选但推荐）

1. 配置Jenkins全局工具

进入“Manage Jenkins”（管理Jenkins）→“Global Tool Configuration”（全局工具配置），设置JDK、Git、Maven等工具路径：

• JDK：点击“Add JDK”，填写名称（如jdk1.8），取消“Install automatically”（自动安装），指定JDK安装路径（如/usr/lib/jvm/java-1.8.0-openjdk）。
• Git：点击“Add Git”，填写名称（如git），指定Git安装路径（如/usr/bin/git）。
• Maven：同理添加Maven，指定MAVEN_HOME路径（如/usr/local/maven）。

2. 配置SSH访问（方便远程操作）

若需通过SSH连接远程服务器，需配置Jenkins用户的SSH权限：

sudo yum install openssh-server -y          # 安装OpenSSH服务器
sudo systemctl start sshd                   # 启动SSH服务
sudo systemctl enable sshd                  # 设置开机自启
sudo adduser jenkins                        # 创建Jenkins用户
sudo passwd jenkins                         # 设置用户密码
sudo vim /etc/ssh/sshd_config               # 编辑SSH配置文件
# 找到`#AllowUsers`，取消注释并添加`AllowUsers jenkins`
sudo systemctl restart sshd                 # 重启SSH服务

3. 配置备份（保障数据安全）

定期备份Jenkins数据目录（/var/lib/jenkins），可使用cron定时任务：

sudo mkdir -p /var/backup/jenkins           # 创建备份目录
sudo crontab -e                             # 编辑定时任务
# 添加以下内容（每天凌晨2点备份）：
0 2 * * * tar -czvf /var/backup/jenkins/$(date +\%F).tar.gz /var/lib/jenkins

4. 配置国内镜像源（加速插件下载）

若插件下载缓慢，可修改Jenkins镜像源为国内镜像（如清华源）：

sudo vim /var/lib/jenkins/hudson.model.UpdateCenter.xml

将< url> https://updates.jenkins.io/update-center.json< /url> 修改为：

<
    url>
    https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json<
    /url>
    

保存后重启Jenkins：

sudo systemctl restart jenkins

六、常见问题排查

• 无法访问Jenkins页面：检查防火墙是否开放端口、Jenkins服务是否启动（sudo systemctl status jenkins）。
• Java环境错误：确认Java版本是否符合要求（Jenkins 2.357及以上需Java 11+），可通过java -version验证。
• 插件安装失败：检查网络连接，或切换至国内镜像源（见步骤5.4）。

通过以上步骤，即可在CentOS系统上完成Jenkins的部署与基础配置，后续可根据项目需求创建Job、配置构建流程。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！