一、安装前准备
在安装jenkins之前,需要先安装JDK和Tomcat
JDK的安装和下载
根据自己的电脑(32位还是64位)选择对应的版本下载。
找到下载的文件,运行".exe"文件,开始安装。
修改JDK的安装路径
开始安装jdk,等待一会儿。
之后出现如下界面,点击"确定"。
安装jre,建议和jdk安装到同一目录下。选择"更改",找到jdk的安装位置,在java文件夹下新建一个jre文件夹用来存放jre文件。
点击"下一步",开始安装jre。
jre 安装完成后,出现如下界面说明jdk已经安装完成了。
接下来开始配置环境变量
在桌面上右击"我的电脑(计算机)–>属性",打开控制面板,选择"高级系统设置"。
在"系统属性"中选择"高级–>环境变量"
在"环境变量"面板中找到"系统变量",选择"新建"。
在’“新建系统变量"对话框中,变量名一栏输入:“JAVA_HOME”,变量值找到jdk的安装路径填入。
接着在"系统变量"中找到"path"变量,选中之后,点击"编辑”。
在变量值一行的末尾输入:";%JAVA_HOME%\bin" 必须是英文。之后确定即可。到此环境变量已经配置好了。
配置好环境变量之后,查看是否配置成功。
打开dos命令窗口,输入"java -version"。出现如下界面,jdk安装成功。
接着输入"java"和"javac" 命令查看相应的功能是否可用。
Tomcat的安装和下载
下载地址: http://tomcat.apache.org/
选择zip(pgp,sha2,sha512)进行下载,下载zip的好处就是不用安装 ,直接下载解压就可以使用了。
下载完成后,直接对压缩包进行解压
选择“此电脑”,单击右键,选择 属性—>高级系统设置—>环境变量(N)…
新建 CATALINA_HOME环境变量,值为tomcat的安装路径
在Path环境变量中新建
%CATALINA_HOME%\lib
%CATALINA_HOME%\lib\servlet-api.jar
%CATALINA_HOME%\lib\jsp-api.jar
添加用户,进入tomcat9的目录的conf,我这里的路径是D:\ProgramFiles\apache-tomcat-9.0.0.M26\conf,
选择“tomcat-users.xml”文件,打开文件后在最后 一行代码的前面添加如下代码:
<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="admin" password="admin" roles="admin-gui"/>
<user username="tomcat" password="admin" roles="manager-gui"/>
添加完成后,保存再退出。
修改端口号
修改tomcat的conf文件夹下的server.xml
打开server.xml
找到下图所在行,把8080改为8082
启动tomcat测试,打开tomcat目录下的bin 文件夹,再双击startup来启动tomcat,启动成功会显示 start Server startup in 8352 ms
如果打开后出现乱码的情况
修改tomcat的conf文件夹下的logging.properties中的参数
java.util.logging.ConsoleHandler.encoding = GBK
将UTF-8改到GBK就行了保存后重启tomcat就正常了。
打开浏览器,在地址栏输入http://localhost:8082 或 http://127.0.0.1:8082进行打开tomcat的主页。
配置完成
二、下载安装jenkins
下载地址 https://jenkins.io/download/
在这里我们下载稳定版
下载成功后 会给到你一个压缩包 解压后得到 jenkins.msi
安装jenkins
点击安装,选择安装路径
安装完成后会自动打开8080网址,稍等一会,或手动刷新即可出现jenkins界面,大概10秒左右的时间
如果出现
Please wait while Jenkins is getting ready to work …
字样,则将hudson.model.UpdateCenter.xml
文件中的url更改
<?xml version='1.1' encoding='UTF-8'?>
<sites>
<site>
<id>default</id>
<url>http://mirror.xmission.com/jenkins/updates/update-center.json</url>
</site>
</sites>
按照给出的目录,将密码复制到密码输入框,点击继续,等待系统初始化,出现自定义Jenkins界面,可以选择安装推荐的插件,括者选择需要的插件来安装,也可以不选择安装,直接点击右上角的X号关闭界面,以后可以通过插件管理器安装插件
这里选择插件来安装,选择之后点击下一步,进入如下安装界面,等待安装完成
如果插件安装失败,可以多次点击重试,或者去插件网站 http://updates.jenkins-ci.org/download/plugins/ 下载需要的plugin,选择匹配的版本号,下载到本地,然后打开:系统管理—插件管理—高级—找到”上传插件”(浏览,找到扩展名为.hpi或者.jpi的插件,上传之后默认直接就安装了。重启jenkins,安装的插件就可以使用了。
添加除了新手推荐需要安装的插件
- Publish Over SSH用于连接远程服务器
- Deploy to container插件用于把打包的应用发布到远程服务器
插件安装完成之后,进入创建第一个管理员用户界面,输入信息,点击保存并完成,添加第一个管理员
安装完成 ,点击开始使用Jenkins
配置本地JDK全局环境,若有Git,Gradle,Ant ,Maven环境都可以在此配置,目前只配置JDK环境和Git环境如下:
修改初始密码
找到当前用户下的config.xml
文件,如下图
使用notepad++打开文件
Ctrl+F找到<passwordHash>
行,将#jbcrypt:
后的内容修改为$2a$10$g0dkZjV//F0pOGou1Xcs0.fAnT6qirKpkJFkmJ3A8qZbZdW7jSWAO
这里修改的新密码为admin
Ctrl+S保存退出,然后重启jenkins服务,就可以使用新密码登录了
修改端口
jenkins的默认端口是8080,容易与其他程序端口冲突,在这里我们可以修改为8081,想要更改Jenkins访问端口号,在Jenkins安装目录下打开jenkins.xml文件
找到如下内容,修改为8081,然后再电脑的服务中找到Jenkins服务,进行重启,然后就可以使用新的端口访问Jenkins了
修改为国内源
使用默认的插件源会出现下载插件失败的情况,这里我们登录jenkins后,
- 进入jenkins系统管理
- 进入插件管理
- 点击高级,修改升级站点的地址为清华大学镜像地址
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
同样修改完之后重启jenkins服务
配置系统设置
1.配置Jenkins Location和系统管理员邮件地址,如下图:
2.配置邮箱:注意这里的发件人邮件地址需与管理员邮件地址一致,否则无法正常发送邮件,以163邮箱配置为例,配置如下:
点击高级配置邮件的账号密码信息
打开后如下图:
重点163邮箱要配置POP3/SMTP/MAP 不然是没发用Jenkins发送邮件的
通过网页邮箱设置授权码,这个将作为第三方登录的密码。
配置完成后,勾选"通过发送测试邮件测试配置,输入收件邮箱地址,点击Test configuration,测试配置邮箱是否能正常发送邮件
3.配置log parse,其中logparse rules如下所示:
配置JDK环境和Git环境
配置本地JDK全局环境,若有Git,Gradle,Ant ,Maven环境都可以在此配置,目前只配置JDK环境和Git环境如下:
- 配置JDK,点击新增JDK,将自动安装复选框的对勾去除,手动添加别名和JDK安装路径
- 配置git,将自动安装复选框的对勾去除,手动添加别名和git安装路径