Jenkins是一款开源的持续集成和持续交付工具,能够帮助开发团队自动化完成代码构建、测试、部署等一系列流程,在Linux系统中安装Jenkins是很多团队搭建自动化环境的基础操作。

安装前环境准备
Jenkins运行依赖Java环境,因此安装前需要先确认系统中已经安装了Java 8或者更高版本的JDK,可以通过以下命令检查Java是否已经安装:
# 检查Java版本 java -version
如果未安装Java,可以先执行以下命令安装OpenJDK 11:
# 更新软件包索引 sudo apt update # 安装OpenJDK 11 sudo apt install openjdk-11-jdk -y
添加Jenkins官方软件源
为了保证安装的是最新稳定版本的Jenkins,建议添加Jenkins的官方软件源,首先导入Jenkins的GPG密钥:
# 导入Jenkins GPG密钥 curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
然后添加Jenkins软件源到系统的源列表中:
# 添加Jenkins源 echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
安装Jenkins
添加完软件源之后,更新软件包索引并安装Jenkins:
# 更新软件包索引 sudo apt update # 安装Jenkins sudo apt install jenkins -y
安装完成后,Jenkins服务会自动启动,可以通过以下命令检查服务运行状态:
# 检查Jenkins服务状态 sudo systemctl status jenkins
如果服务正常运行,会看到输出中包含active (running)的标识。
配置防火墙(可选)
如果系统开启了防火墙,需要开放Jenkins默认的8080端口,允许外部访问:
# 开放8080端口 sudo ufw allow 8080 # 重新加载防火墙规则 sudo ufw reload
初始化Jenkins
在浏览器中访问http://服务器IP:8080,首次访问会进入初始化页面,需要输入管理员初始密码,可以通过以下命令获取初始密码:
# 获取Jenkins初始管理员密码 sudo cat /var/lib/jenkins/secrets/initialAdminPassword
将获取到的密码粘贴到页面输入框中,点击继续,之后可以选择安装推荐的插件,或者自定义选择需要安装的插件,等待插件安装完成。
插件安装完成后,会提示创建第一个管理员用户,填写相关信息后保存即可完成初始化,之后就可以正常使用Jenkins的各项功能了。
常见问题解决
Jenkins服务启动失败
如果服务启动失败,首先检查Java是否正确安装,然后查看Jenkins的日志文件定位问题:
# 查看Jenkins日志 sudo tail -f /var/log/jenkins/jenkins.log
端口被占用
如果8080端口被其他服务占用,可以修改Jenkins的配置文件修改默认端口:
# 编辑Jenkins配置文件 sudo vim /etc/default/jenkins # 找到HTTP_PORT=8080,修改为其他未被占用的端口,比如8081 # 保存后重启服务 sudo systemctl restart jenkins