前置环境

本教程所处环境:

操作系统: Windows 2012R2 服务器系统

JDK: Java 11, 推荐(Java 17 或 Java 21) 这样的话可以在Jenkins中直接下载插件

软件: 宝塔面板 Jenkins 2.426.1

下载和安装

下载

到官网: Jenkins 下载最新的msi包, 然后运行:

下载的文件类型:

安装

双击下载的msi文件, 然后一路下一步即可.

但是这里我们选第一个

端口根据实际情况修改, 这里我后续改成了8999

Java路径根据实际情况修改, 这里我选的是jdk11的路径

然后就可以一直下一步了, 安装完成后, 会自动打开浏览器, 然后会提示输入密码, 这个密码在安装目录下的secrets/initialAdminPassword文件中, 打开后复制粘贴即可.

如果没有自动打开浏览器, 可以手动打开浏览器, 输入http://localhost:8999即可.

打开后如图:

直接按照提示输入密码即可.

然后我们点击自定义安装, 选择安装插件, 这里我们选择推荐插件即可.

但是你会惊奇的发现所有的插件都是失败的, 这是因为我们的网络问题

(因为本教程是基于Java 11, 建议安装17 或者 21 版本解决这个问题, 下面有关插件安装问题可以忽略)

如图:

我们点击继续,进入到创建管理员界面, 这里我们可以直接点击继续即可.

输入用户名和密码, 然后点击保存并完成即可.

安装插件

如果前面的插件安装失败, 我们可以手动安装插件. 但是需要修改一下配置文件.

进入插件管理界面:

高级选项:

拉到下面, 修改升级站点为http://mirror.esuni.jp/jenkins/updates/update-center.json

点击提交即可.

有关镜像问题, 或许可以在这里尝试找到一些解决方案: 插件更新中心

汉化插件

我们需要安装汉化插件, 这样界面才是中文的.

我们去插件管理页面,点击可选插件, 搜索Locale并安装:

然后再次搜索Localization并安装(2个):

但是由于网络问题,插件大概率安装失败:

但是可以手动安装, 进入官网插件下载页面:

按顺序下载:

然后我们来到高级设置, 手动选择插件:

按顺序依次安装完毕后, 到系统设置设置默认语言zh_CN.

然后重启Jenkins即可(http://127.0.0.1:8999/restart)

必须插件

我们需要安装一些必须的插件, 这样才能使用Jenkins.

1.git

2.gitee

3.Generic Webhook Trigger Plugin

如果安装失败, 重复上面汉化的手动安装方式即可.

创建任务

我们需要创建一个任务, 这样才能使用Jenkins.

回到首页,点击create new jobs:

输入信息,选择Freestyle project:

点击OK后, 进入到配置页面:

配置Gitee

去到系统设置, 点击Gitee配置,令牌个根据页面提示获取:

配置用户Token

进入到用户配置界面, 生成一个token并复制,然后保存

后面的gitee webHooks需要用到:

配置任务

刚才我们创建了一个任务, 现在我们需要配置任务.

源码管理

进入到任务配置界面, 点击源码管理, 选择git, 然后填写仓库地址

Credentials可以选择用户名密码, 也可以选择token, 这里我们选择token: (如果你的列表里面显示无, 那不选也没关系)

其它的可以不用管

构建触发器

如图,勾选Gitee webhook触发器

往下拉, 勾选Generic Webhook Trigger (如果没有这个选项, 去插件那里安装)

找到Token输入框, 还记得在配置用户信息时复制的token吗, 这里我们需要粘贴进去:

Build Steps

这里就是我们的项目该如何打包,甚至打包后我们该如何处理打包后的产物

根据项目的不同,这里我们配合宝塔面板的项目, 我们选择Windows batch command

然后输入打包和复制的命令:

npm run build就是打包命令, 如果构建前需要安装依赖,可以在这命令之前加上npm install

xcopy /E/Y .\doc C:\wwwroot\doc就是复制命令 将当前目录的doc文件夹复制到C:\wwwroot\doc目录下

如果使用move命令,会提示拒绝访问,有谁知道怎么解决吗😗

构建后的操作

这里填写后,当项目成功构建时,可以查看到构建的结果

目录的起始就是当前任务所处的文件夹的目录,doc就是打包后生成的文件夹,(原来是dist,可以在项目的配置文件中更改)

以下就是该任务的目录文件夹示意:

点击保存.

初次构建

终于来到这里了😂😂😂

我们回到任务页面, 点击Build Now

然后我们点击红框里面的内容,可以看到构建产生的文件,也可以看到控制台输出

构建完成如图所示

gitee WebHooks

进入gitee项目,然后找到WebHooks

配置WebHooks

URL的格式就是

http://管理系统的地址/generic-webhook-trigger/invoke?token=之前生成的用户的token

管理系统的地址 = jenkins.fanshu.xyz 或者 127.0.0.1:8999

(jenkins.fanshu.xyz这是我配置了域名)

然后点击保存返回WebHooks首页,点击测试:

有数据返回就是成功

如果是403就需要去系统设置里配置, 任何人可以做任何事😁

这一步如果配置成功,以后当我们向master分支推送代码时,会自动触发打包命令,并且把打包结果复制到宝塔的项目目录下