万人坑：本地环境配置及Jenkins部署踩坑指南

万人坑：有些网站真的是非常非常非常坑，不仅按照他们的方法一次都没成功，还遇到了各种千奇百怪的问题，浪费了本人3.1415926h的时间。下面开始踩坑之路！

一.本地环境

jdk：1.8

tomcat：8.5.59

jenkins：2.264

git：2.34.0

allure：2.17.3

二.下载安装

1.jdk下载安装

参考：https://www.cnblogs.com/lihongtaoya/p/16971096.html

2.tomcat下载安装

1.下载地址：https://archive.apache.org/dist/tomcat/，这里我下载的是免安装版本，下载完解压到本地目录里

2.解压完成后进入bin目录下打开startup.bat(win)，出现闪退，无法启动

踩坑1：

谁的文章我也不说了，按照他的方式，配置环境变量，配置jdk环境变量(这个第一步就配置好了)，配置jdk jre路径变量，配置tomcat环境变量。配置完后重启，结果可想而知。

踩坑2：

端口号被占用，tomcat默认端口是8080，查看进程发现确实被其它应用占用，把原来进程杀掉，再次重启startup，结果闪退

踩坑3：

既然杀原来的进程不行，那就改tomcat默认端口，conf目录下找到server.xml修改port，结果闪退

踩坑4：

编辑startup.bat文件，将JAVA_HOME，CATALINA_HOME配置添加到文件开头部分

接着再运行startup.bat成功，运行成功，还算可靠，浏览器输入：http://127.0.0.1:8080

3.启动后发现乱码，解决：修改conf目录下logging.properties文件，将如下UFT-8改成GBK

三.jenkins下载部署

1.下载

1）下载地址：https://mirrors.tuna.tsinghua.edu.cn/jenkins/war/，我这里下载的是war包，可以直接使用

2）将下载好的war包复制到tomcat解压目录webapps目录下，然后浏览器执行：http://127.0.0.1:8080/jenkins，然后页面提示请求的资源[/jenkins]不可用，哎，没办法，那就接着踩坑之路。

踩坑1：

tomcat版本过高或过低不支持，说是tomcat9支持，行吧，我就把8.5.59换成了9.0.93，然后启动，运行，请求，一气呵成，结果资源不可用

踩坑2：

jenkins版本过高，刚开始我使用的是最新的war包2.471，想着也是，于是换成了当前网站最低的版本，然后启动，运行，请求，一气呵成，结果资源不可用

踩坑3：

看tomcat日志报错是【至少有一个JAR被扫描 用于TLD但尚未包含TLD。 为此记录器启用调试日志记录，以获取已扫描但未在其中找到TLD的完整JAR列表。 在扫描期间跳过不需要的JAR可以缩短启动时间和JSP编译时间】于是又开启了踩坑，进入conf目录下找到catalina.properties，将=/改成=*.jar，然后启动，运行，请求，一气呵成，结果资源不可用。还引发了其它报错，好家伙，真的好家伙

踩坑4：

最后实在没法办，找同事要了个jenkins.war2.246包，然后启动，运行，请求，一气呵成，结果没想到成功了，此时此刻只想说，世界上离成功最遥远的距离就是网上查答案。

2.jenkins基础配置

1）以上工作都准备好了，请求http://127.0.0.1:8080/jenkins，第一次会提示设置密码。

不知道密码的，请看图文说明。输入密码后要求下载插件，此时千万千万千万千万...........不要下载。要是下载了

然后你就会发现，全部失败，因为这里下载的插件都是最新的，而我们装的jenkins版本过低，版本不支持，后面处理非常麻烦。

继续踩坑：

踩坑1：

进去jenkins配置下载源，然后更新插件，结果什么用也没有

踩坑2：

删除下载的插件，进入.jenkins\plugins文件下，删除所有以.jpi结尾的文件，结果什么用也没有

解决：

这个时候可以关闭服务，找到.jenkins》updates》default.json文件，这个文件配置的是默认下载源，我们需要改成与版本相匹配的，地址：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/，找到对应的dynamic-2.264/update-center.json，可以直接请求，拿到json返回数据，直接替换default.json里的内容，注意要删除updateCenter.post();，只取响应的内容即可。然后再重启服务，下载插件就可以发现全部下载成功。然后就进去填写登录的用户名和密码页面

配置实例，默认就行吧，完成了就进入到了jenkins页面了

2）Manage jenkins》manage plugins》advanced设置国内下载源

地址：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/，记得粘贴与jenkins匹配的版本。

3）配置jdk

进入Manage jenkins》Global Tool Configuration下找到jdk

4）git配置

进入Manage jenkins》Global Tool Configuration下找到git

图中路径应该是git目录运行路径，可在命令窗口输入：where git  查看

5）allure配置

进入Manage jenkins》Global Tool Configuration下找到allure

3.创建job

新建item》如果做自动化，用不到maven，能用到的是FreeStyle Project和Pipeline Project。这里就介绍前者了。

进入job配置页面，选择源码管理，配置git信息

设置脚本执行代码

设置allure配置（设置两个地址）

配置完成后执行构建计划就可以了