Jenkins搭建 - 教学详细篇

本文讲解一下在Windows上如何搭建jenkins。需要配置三样东西:JDK, tomcat, jenkins.war。

目录

一、安装JDK并配置环境变量

二、下载tomcat

三、下载jenkins.war

四、启动tomcat服务

五、配置jenkins

六、最后分享一些容易踩得坑,以及小Tips。


我使用的是版本是JDK8, tomcat9,以及最新版的jenkins。

首先讲一下注意点也是坑:

  1. tomcat9的推荐版本是jdk8,而jenkins的推荐版本是jdk11,所以我们需要下载jdk8,否则tomcat没法使用。
  2. 尽量下载一个高版本的jdk8,最好是最新版本的,不然如果jdk8版本过低,那么jenkins安装好后,会显示离线状态。

一、安装JDK并配置环境变量

1. 从官网(点击跳转)下载最新的jdk8的版本

Jenkins搭建 - 教学详细篇

Tips: 官网下载jdk现在比较麻烦,需要注册登录账号后才能下载,想要下载官网上的注册账号登录即可,且官网速度较慢,想快点的同学可以使用华为的镜像站:https://repo.huaweicloud.com/java/jdk/ 找到自己想要的版本安装。

2. 双击安装下载好的jdk8,过程默认安装即可。

3. 安装好之后,配置环境变量(Win11)

右键点击此电脑,点击属性

Jenkins搭建 - 教学详细篇

在弹出的系统设置界面选择高级系统设置,在打开的高级面板中然后选择环境变量

Jenkins搭建 - 教学详细篇

在系统环境变量下面新建JAVA_HOME变量

JAVA_HOME
C:\Program Files\Java\jdk1.8.0_202

Jenkins搭建 - 教学详细篇

4. 打开cmd窗口,输入java -version输出我们下载的版本号即配置成功。

二、下载tomcat

直接百度搜索tomcat第一个就是tomcat官网(点击跳转)

1. 点击which version可以查看tomcat各版本所支持的java版本。

Jenkins搭建 - 教学详细篇

2. 下载tomcat9

点击Tomcat9,可以看到下载的版本是9.0.58,点击下载对应的服务器安装包。

 Jenkins搭建 - 教学详细篇

 3. 解压刚下载好的zip包到你想要安装的盘的根目录,我安装在C盘根目录。

三、下载jenkins.war

直接百度搜索jenkins第一个就是jenkins官网(点击跳转),

1. 点击download跳转到下载页面,左边的是稳定版,右边的是会每周发布的版本。

Jenkins搭建 - 教学详细篇

2. 点击下载左边的war包

3. 复制粘贴下载的jenkins.war到tomcat安装路径的webapps目录下即初步配置完成

Jenkins搭建 - 教学详细篇

四、启动tomcat服务

1. 打开tomcat文件夹下的bin文件夹,双击打开start.bat文件,会弹出一个命令窗口等待服务加载完成,第一次启动会有点慢,耐心等待即可。

2. 当出现jenkins is fully up and running时,说明服务启动成功。--- 强调:只要使用jenkins,那就千万不能关闭命令窗口,将它最小化之后保持后台运行状态即可!!!Jenkins搭建 - 教学详细篇

 3.将命令窗口最小化,然后在浏览器上输入网址http://localhost:8080,能打开tomcat首页说明前面的配置都是正确的。

Jenkins搭建 - 教学详细篇

五、配置jenkins

1. 在之前的网址上加上jenkins即http://localhost:8080/jenkins/就能打开jenkins页面了。

Jenkins搭建 - 教学详细篇

 2. 第一次打开jenkins会要求输入密码,根据网页提示找到对应路径下的initialAdminPassword,然后复制其中的密码粘贴到网页上然后点击Continue。

3. 选择推荐的插件进行安装,时间会比较久,也可以选择自定义插件安装。

4.下载完插件之后,会跳转到新建账号的页面新建一个账号,邮箱最好是发件箱。

Jenkins搭建 - 教学详细篇

 5. 创建完账号会跳转到设置URL页面,我们可以先跳过,后面再根据具体需求去更改。

6. 点击下一步,当出现Jenkins is ready! 那恭喜您,jenkins配置成功,可以开始使用了。

Jenkins搭建 - 教学详细篇

7. 点击开始使用即可跳转到jenkins首页,开始我们的工作任务了。

Jenkins搭建 - 教学详细篇

六、最后分享一些容易踩得坑,以及小Tips。

  1. 有时双击startup.bat文件,可能闪退------检查环境变量,确保有正确JAVA_HOME
  2. tomcat默认的端口号是8080,如果8080被占用,也可能造成闪退
    1. 首先在doc窗口输入命令netstat -ano|findstr 8080
    2. 其次在任务管理器中,找出占用8080的进程
    3. 如果进程可以关闭,那么结束该进程
    4. 如果进程很重要,不应该结束进程,那么就修改tomcat端口号
  3. 修改tomcat端口号:
    1. 在tomcat的conf文件夹下用记事本打开server.xml文件
    2. 按ctrl+h, 把8080替换成8089(随便一个不被占用的号即可:1000以上能记住的)
    3. 保存
    4. 以后打开浏览器时,网址就要从http://localhost:8080/ 改成http://localhost:8089
  4. 如果tomcat默认启动有乱码:
    1. 在tomcat的conf文件夹下用notepad++打开logging.properties文件
    2. 把java.util.logging.ConsoleHandler.encoding = UTF-8
    3. 改成java.util.logging.ConsoleHandler.encoding = GBK
    4. 重新启动tomcat,中文就能正常显示了
  5. 如果提示缓存不足
    1. 在tomcat的conf文件夹下用notepad++打开content.xml文件
    2. 在其中增加一行<Resources cachingAllowed="true" cacheMaxSize="1000000" />
上一篇:Jenkins 的用户权限和凭证管理


下一篇:jenkins执行远程服务器命令返回code127解决办法