Jenkins是一款开源软件项目,基于Java开发的开源软件,用于监控持续重复的工作,旨在提供一个开放易用的软件平台,提供任务构建、持续集成监控的功能,可以使开发测试人员更方便的构建软件项目,提高工作效率,使软件的持续集成变成可能。
目录
前置条件
需要安装JDK,并且已经配置环境变量,注意版本兼容性!
win10安装JDK1.8及环境变量: https://blog.csdn.net/qq_37138756/article/details/100511976
Linux安装JDK1.8及环境变量:https://blog.csdn.net/qq_37138756/article/details/103579852
通过 java -version 或 javac 来查看java版本号,并且验证环境变量是否可用
Window 10 安装程序安装
Windows平台下,一般安装方法有2种:安装程序安装和war包安装
程序安装地址:https://jenkins.io/download/thank-you-downloading-windows-installer-stable/
windows安装比较简单,双击下载的Jenkins安装包 Jenkins.msi ,进入安装模式,选择默认配置,一路next直至安装完成。
安装完成后直接打开浏览器,输入http://localhost:8080进行操作即可
注意:客户端安装,可以通过Jenkins安装目录下打开jenkins.xml文件,更改端口号,然后在电脑图标上右键 --> 点击"管理" --> 在左侧节点中选择"服务和应用程序" --> "服务",在右侧服务列表中找到Jenkins服务,进行重启,然后就可以使用新的端口访问Jenkins了
jenkins.xml文件:
Window 应用服务:
war包安装
这里war包依Window环境为例
war包也可以应用于Linux环境下
进入到Jenkins官网下载:https://jenkins.io/download/
下载完成后将.war包放到存放目录下
在文件地址栏输入cmd,进入dos界面,保证目录在存放jenkins.war包目录下。dos界面中输入以下命令来启动Jenkins,默认端口号为8080
java -jar jenkins.war
启动成功后最后一行会提示:Jenkins is fully up and running (启动后命令行窗口不要关)
因为jenkins的war包自带jetty服务器,所以启动成功后,直接打开浏览器,输入http://localhost:8080操作即可,进入页面会显示 Jenkins正在启动,请稍后... ,这个过程需要一段时间,耐心等待启动完成。
注意:
war包也可用于tomcat等容器下
如果启动的时候提示端口已经被占用,或者需要更换端口号,在启动的时候通过 httpPort 参数来指定端口。例:
java -jar jenkins.war --httpPort=8081
CentOS 7 (Linux)安装
下载地址:https://jenkins.io/download/
根据需要下版版本,注意版本兼容问题:
可以本地先进行下载,下载完成之后上传到服务器进行安装,也可以服务器直接下载安装
本地下载,直接选择需要安装的版本下载即可
1 这里在服务器进行下载安装,输入以下命令安装下载依赖:
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
输入命令如果报:command not found!
需要安装wget,输入以下命令使用yum安装wget:
yum -y install wget
安装完成以后再执行以上Jenkins安装命令
安装过程中有点慢,需要等待一会。
2 安装秘钥
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
在安装过程中出现以下错误,看看服务器是不是非锁屏,有可能是网络不好,稍等一会再试试
安装完成后没有提示
3.安装
yum install jenkins
在安装过程中,需要确定安装,输入:y
当看到jenkins版本和complete字样时,表示已经安装完成
jenkins相关目录释义:
/usr/lib/jenkins/ jenkins安装目录,war包会放在这里。
/etc/sysconfig/jenkins jenkins配置文件,“端口”,“JENKINS_HOME”等都可以在这里配置。
/var/lib/jenkins/ 默认的JENKINS_HOME。
/var/log/jenkins/jenkins.log jenkins日志文件。
4 修改端口号
配置jenkins端口,需要修改Jenkins配置文件,输入以下命令
vi /etc/sysconfig/jenkins
可以看到Jenkins默认端口号为:8080,如果有需要可以修改,我这里就不做变动了
修改按下键盘上的:"i",进入编辑模式。修改完成后按下"Esc"键,输入:"wq!" 保存并退出
5 运行,通过以下命令
service jenkins restart
如果在运行的时候出现以下错误,是jdk配置的原因
输入以下命令,配置jdk安装目录(以自己安装目录为准)
vi /etc/init.d/jenkins
jdk配置完成后,重新启动,出现ok提示,表示启动成功。
访问通过地址加端口号来访问。
注意:
停止运行使用:
service jenkins stop
外部访问Jenkins的时候,服务器需要关闭防火墙,否则是连接不上的,此处以CentOS 7 来关闭防火墙,不同版本防火墙不一样
查看防火墙状态:
sudo systemctl status firewalld
关闭防火墙:
sudo systemctl stop firewalld
禁止firewall开机启动:
以上关闭防火墙的命令是暂时的,重启服务后又会回到默认的状态。如果想重启电脑后防火墙还是关闭状态,则使用如下命令
sudo systemctl disable firewalld
配置(通用可参考)
1 创建管理员账号
第一次使用jenkins时,为了安全考虑,会生成一串字符口令,进入对应的路径,打开该文件,将对应的字符复制进输入框内,点击继续按钮,等待安装成功。
进入目录找到密码后复制到输入框,点击继续
接下来会出现如下的页面,点击跳过插件安装
接下来就是创建一个管理员账号了,界面如下:
输入用户名,密码,点击保存并完成
新手入门,修改jenkins访问Url为本机ip,点击保存并完成,到这里就安装成功了
注意:
为了避免端口占用,建议将8080端口该成不常用的端口
如果更改失败的话,打开终端,cd 到Jenkins的安装目录(即jenkins.war所在目录),例如:E:\Jenkins,执行以下命令:
java -jar jenkins.war --ajp13Port=-1 --httpPort=8081
2 系统管理
在Jenkins主界面点击系统管理,进入系统设置页面,选择配置系统
设置jenkins地址和管理员邮箱地址
Jenkins URL: 用来设置Jenkins访问地址和端口号
System Admin e-mail address :Jenkins 操作通知邮箱,收件人邮箱可以添加多人,中间用英文半角逗号","隔开即可
设置发件人等配置信息
注意:这里的发件人邮箱地址切记要和系统管理员邮件地址保持一致
配置完成后,点击"save"
建议:
配置完成后,最好选择"Test configuration by sending test e-mail",进行测试下。看看配置有没有问题
3 插件管理
在Jenkins主界面点击系统管理,进入系统设置页面,选择插件管理
进入到插件管理界面发现错误:There were errors checking the update sites: SocketTimeoutException: connect timed out
这种问题选择,同级菜单下的“advance”标签
打开后滑到最下边,将“Update Site”参数设置为:http://mirror.xmission.com/jenkins/updates/update-center.json
点击“check now”;
再回到“available”标签页,就会看到错误已经接近,而且可选插件列表不再为空了。
如果需要安装插件可以在“” 标签中找到需要下载的插件选中(我这里选中了SVN 和Git),点击“Install Without restart”进行安装
全部安装成功后点击“Go back to the top page”回到首页
4 配置环境
在Jenkins主界面点击系统管理,进入系统设置页面,选择全局工具配置
Git,Gradle,Ant ,Maven等环境都可以在此配置
配置环境前提条件是Jenkins中有插件支持,而且本地环境是可用状态,选择需要配置的环境,输入别名和安装路径,然后点击"save",(我这里只配置了jdk和maven,非强制性根据自己需要配置)
注意:
如果想要配置变量,除了自带的依赖,其它需要先下载插件支持
也可以勾选自动安装,然后保存,这样jenkins会自动为你下载并安装!(不建议使用)
我这里只配置了JDK和maven,具体根据自己的需要来配置。
使用问题
1 在初次启动Jenkins的时候,输入初始化密码后,一直卡在加载页面,如下:
解决:
在地址栏输入http://192.168.3.12:8080/pluginManager/advanced,进入到插件管理器
页面滑动到最下面,替换一下信息,点击submit。
http://mirror.xmission.com/jenkins/updates/update-center.json
替换完成以后重启服务器,即可解决。
2 Dependency errors: Some plugins could not be loaded due to unsatisfied dependencies. Fix these issues and restart Jenkins to restore the functionality provided by these plugins.
进入到系统管理界面出现以下错误,是因为插件缺少依赖,需要重新下载依赖,例如以下错误,缺少h2-api 依赖,依赖版本:1.4.199
插件管理中选择可用插件搜索缺失插件,选中下载重新启动即可