Jenkins 的安装(详细教程)

迈不过友情╰ 2024-04-22 22:01 75阅读 0赞

#### 文章目录 ####

*  一、简介
 *  二、安装前准备
 *  三、windows 安装与启动
 *   *  1. 方式一
     *  2. 方式二
     *  3. 方式三
 *  四、创建管理员用户
 *  五、常用设置
 *   *  1. 配置镜像地址
     *  2. 更改工作目录
     *  3. 开启可注册用户
     *  4. 全局变量配置

--------------------

## 一、简介 ##

官网：[https://www.jenkins.io][https_www.jenkins.io]

中文文档：[https://www.jenkins.io/zh/][https_www.jenkins.io_zh]

![在这里插入图片描述][808b30634d244aa2a14b7a34174e23fd.png]

`Jenkins` 是一个开源的持续集成（CI）工具，用于自动化构建、测试和部署软件项目。它提供了一个易于使用和可扩展的平台，帮助团队更高效地开发和交付软件。

`Jenkins` 的主要特点和用途包括：

1.  自动化构建：`Jenkins` 可以从源代码库（如`Git`、`SVN` 等）中获取最新的代码，并自动进行构建。它支持各种构建工具和构建脚本，如`Ant、Maven、Gradle` 等。
2.  持续集成：`Jenkins` 可以将多个开发者的代码集成到共享的主线分支中，并定期执行构建和测试。这有助于发现和解决集成问题，确保软件的稳定性和可靠性。
3.  测试自动化：`Jenkins` 可以与各种测试框架和工具集成，如 `JUnit、Selenium、JMeter` 等。它可以自动执行各种测试，并生成测试报告和分析结果。
4.  部署自动化：`Jenkins` 可以自动化部署应用程序到目标服务器或云平台。它支持各种部署工具和配置管理工具，如 `Docker、Kubernetes、Ansible` 等。
5.  插件生态系统：`Jenkins`拥有一个强大的插件生态系统，提供了各种功能和集成选项。用户可以根据需要选择和安装插件，以扩展和定制 `Jenkins` 的功能。

总之，`Jenkins` 是一个功能强大、易于使用的持续集成工具，可以帮助团队实现软件开发和交付的自动化。通过自动化构建、测试和部署过程，可以提高团队的效率、减少错误，并加速软件项目的交付。

--------------------

## 二、安装前准备 ##

在安装 `jenkins` 之前要先确保电脑上是否已配置过 `Java` 的环境变量，可调出命令窗口（`win + R` 再输入 `cmd`），通过 `java -version` 来检验

![在这里插入图片描述][41c8d88ba6034707af5cf9fece64049f.png]

如果没有显示 `Java` 的版本信息，就需要先配置 `Java` 环境变量，具体操作可参见：[Java-环境配置(详细教程)][Java-]

--------------------

## 三、windows 安装与启动 ##

进入 `Jenkins` 的 [官方下载页面][Link 1]

![在这里插入图片描述][bd3232e561ed44379e45f8f2766a3477.png]

`LTS` 是长期支持的版本，是稳定的版本

在 `Windows` 下 `Jenkins` 的安装有三种方式：

*  方式一：下载 `war` 包通过命令启动
 *  方式二：`war` 结合`tomcat`进行安装
 *  方式三：下载安装程序包 `msi` 文件

在下载安装包之前要先确定应该下载哪个版本的 `Jenkins`，`Jenkins` 的版本依赖于 `Java` 的版本，可在 [Jenkins-Java Support Policy][] 中进行查看

![在这里插入图片描述][4cf561c5a37a4888b95c7e17229efc08.png]

如果你下载的 `Jenkins` 版本与本地 `Java` 不支持，那么 `Jenkins` 是无法安装成功的，比如说我电脑上 `JDK` 的版本是 `1.8.0_172`，也就是 `Java 8`，那么我只能安装 `2.346.1` 或者该版本之前的，在 `Past Releases` 上可以查看到历史版本

![在这里插入图片描述][542c1e0f14c243f8bd35189634293842.png]

页面如下 ：

![在这里插入图片描述][bff229f4787a44f6b94ad8903effb915.png]

--------------------

### 1. 方式一 ###

`jenkins` 可以通过 `war` 的形式安装起来，`war` 包可以通过 `java -jar` 的命令或者放到 `Tomcat` 上启动起来

首先需要下载 `Java` 所支持的 `jenkins` 版本，我用的时 `Java-8`，所以我就下载 `2.332.4` 的

![在这里插入图片描述][2b81914134034ff5b7c8e6edbb343999.png]

![在这里插入图片描述][1d5f8f695df6457ca1e67e5c7660c231.png]

下载完成后，在 `war` 包所在目录下进入 `cmd 命令`，通过以下命令

java -jar jenkins.war --httpPort=8080

![在这里插入图片描述][b7ad962325c34259ad5e70fd3c63a97c.png]

![在这里插入图片描述][3fbb4c9fdb7a4d198aee3b0009b6f216.png]

当看到 `Jenkins is fully up and running` 就表示 `jenkins` 已经启动完成了

下一步：跳转至 —> 创建管理员用户

--------------------

### 2. 方式二 ###

[Tomcat 的安装(详细教程)][Tomcat]

按照 `方式一` 的步骤下载 `war` 包，再将 `war` 放到 `tomcat` 的 `wabapps` 的目录下

![在这里插入图片描述][72350193813940389cf55d99c7f03105.png]

启动 `tomcat`，访问 `localhost:tomcatPort/jenkins`，例如：[http://localhost:8080/jenkins][http_localhost_8080_jenkins]

![在这里插入图片描述][0fc525f24d344a6b9e3575bed775fa2e.png]

下一步：跳转至 —> 创建管理员用户

--------------------

### 3. 方式三 ###

在 `LTS` 下选择 `Windows`

![在这里插入图片描述][3127bbaa9f6b4536a56294a1b8e98893.png]

即可下载到一个 `jenkins.msi` 安装程序包

![在这里插入图片描述][813b03f24f374cda835e01761ac494cf.png]  
注意：我没有找打 `Java 8` 支持的 `jenkins.msi`，包括一些开源的镜像站，如果用这种方式下载 `Jenkins`，建议先下载一个 `JDK 11`

双击运行

![在这里插入图片描述][c981e7ffbf6549089f4d7b5fca2903bf.png_pic_center]

点击 `Next`

![在这里插入图片描述][d05f32907f464f339817c2d833e322bc.png_pic_center]

选择 `安装路径`，再点击 `Next`

![在这里插入图片描述][f14b32cf7a914884b418d0eb033a087d.png_pic_center]

选择 `Run service as LocalSystem (not recommended)`，点击 `Next`

![在这里插入图片描述][5fc2406249ad468183edc743bb9b8ec5.png_pic_center]

设置 `端口号`，测试端口号是否可行，`可行之后` 才能点击 `Next`

![在这里插入图片描述][692a88f00ad247aaa39c3060cb730a1f.png_pic_center]

选择 `JDK` 的安装路径，再点击 `Next`

![在这里插入图片描述][85bae27b11f4420983477aa4f73cfffe.png_pic_center]

点击 `Next`

![在这里插入图片描述][38f59b27faf647a18d0ffec3580c07fe.png_pic_center]

点击 `Install` 进行安装

![在这里插入图片描述][3652cac8bdf04d0aaf00e110044d47a5.png_pic_center]

点击 `Finish` 完成安装

--------------------

## 四、创建管理员用户 ##

安装完成之后在游览器上访问 `localhost:port` ，`port` 是安装时设置的端口号，比如：[localhost:8080][localhost_8080]

注意：不同版本的 `jenkins` 页面可能会有点差异

![在这里插入图片描述][4465df09adaa43c892dcbebec3b93683.png]

根据提示的路径就能找到存放 `管理员密码` 的文件 `initialAdminPassword`

![在这里插入图片描述][d8afb9f771f64b559ba20db6a8eb22db.png]

不过此时暂时不用着急地去粘贴 `管理员密码`，因为 `jenkins` 的服务器在国外，到安装插件步骤时会加载得比较慢

建议先去设置成国内的镜像 —> 点击跳转查看具体步骤

配置好镜像重启后再访问 `localhost:port`，从本地复制密码并粘贴到指定位置

![在这里插入图片描述][82ea638ba6de464fbea03244f52096e3.png]

点击 `继续`

![在这里插入图片描述][96dbd60eac114dbe834da57c287bc798.png]

如果刚刚已经换成国内的镜像网址了，所以可以直接选择 `安装推荐的插件`，让它自动下一些常用的插件也很快

如果没有替换成国内镜像，直接 `安装推荐的插件` 会比较慢，也可以点击 `选择插件来安装`，再点击 `无`，不安装任何插件，再点击 `安装`

![在这里插入图片描述][b9175024cd9f48ca994d31fba8cbf657.png]

并且成功率比较高

![在这里插入图片描述][2552677cd2384cbc84dee4b958a08abc.png]

对应那些安装失败的插件可以 `重试` 再安装，有些插件会因为依赖的关系安装不上的话就 `继续` 也没啥影响

![在这里插入图片描述][807a816ae66c4795b31ff2ec80d032de.png]

创建 `管理员用户` 之后，点击 `保存并完成`

![在这里插入图片描述][6b5f656ab3324afbbb5495dee6ccc7af.png]

点击 `保存并完成`

![在这里插入图片描述][1ee2867f111b4d868ff699a698307163.png]

到此为止 `jenkins` 就安装完成了，可以点击 `开始使用 jenkins`

![在这里插入图片描述][31008261ea6847daba3615bb6e286c5d.png]

--------------------

## 五、常用设置 ##

### 1. 配置镜像地址 ###

在 `jenkins` 的工作目录 `.jenkins` 中，找到 `hudson.model.UpdateCenter.xml` 文件打开

将 `https://updates.jenkins.io/update-center.json` 替换成国内镜像网址（需要管理员权限修改）

*  [国内镜像网址][Link 2]：`https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json`
 *  [国外镜像网址][Link 3]：`https://mirror.xmission.com/jenkins/updates/update-center.json`

![在这里插入图片描述][6b8d29ff55ff4da1a4ca2ceaf457ce71.png]

再进入到 `updates` 目录下，编辑 `default.json` 文件，将该文件中国外的地址全部替换成国内的（需要管理员权限修改）

*  `https://www.google.com` 替换成 `https://www.baidu.com`
 *  `https://updates.jenkins.io/download` 替换成 `https://mirrors.tuna.tsinghua.edu.cn/jenkins`

![在这里插入图片描述][86b499d9d5df4dcca9f5c2c577e2285d.png]

修改完配置之后需要重启 `jenkins`， `Win + R` 运行 `compmgmt.msc`

![在这里插入图片描述][84510f4871874e418a193fa23ccc807e.png_pic_center]

打开 `计算机管理` 界面

![在这里插入图片描述][14925ec7d77b4289a8c446645931397b.png]

在 `服务和应用程序` \- `服务` 下找到 `jenkins` 服务，选中右键，点击 `重新启动`

![在这里插入图片描述][5f600eef21dd443bba70246a86c491fb.png_pic_center]

--------------------

### 2. 更改工作目录 ###

从上面安装过程可知 `Jenkins` 的工作目录默认在 `C` 盘下，而 `C` 盘的资源是比较珍贵的，一般情况下会尽量避免将工作目录放置 `C` 盘中，所以在有些情况下可能就需要更改工作目录

在 `计算机管理` 界面中先停止 `jenkins` 程序

再打开 `jenkins` 的安装目录，找到 `jenkins.xml` 文件，进行编辑

![在这里插入图片描述][7f8c991d1ce34bfab97e00e2979a3484.png]

将 `%ProgramData%\Jenkins\.jenkins` 修改为目标目录，比如：`D:\jenkins\windows\jenkins-2.440-work`

重启 `jenkins` 即可

--------------------

### 3. 开启可注册用户 ###

默认情况下是不可以注册用户的，如果想要开启注册用户，以 `2.440.1` 的 `jenkins` 版本为例，在 `Manage Jenkins` \- `Security` 中选中 `Security`

![在这里插入图片描述][1f7aa079996e4e0aab29de874b72ebe1.png]

进入到以下页面

![在这里插入图片描述][6767a5c6eef54c53a4ca007021f1cb41.png]

开启 `允许用户注册`，再点击 `应用` 和 `保存`

![在这里插入图片描述][45afeb6d7b0f4971863251e1f2a192f0.png]

回到登录页面就能看到已经可以注册用户了

--------------------

### 4. 全局变量配置 ###

以 `2.440.1` 的 `jenkins` 版本为例，在 `Manage Jenkins` \- `System Configuration` 中选中 `Tools`

![在这里插入图片描述][b6d9214a391543d0946f2aebf7a17206.png]

在这里就可以配置 `JDK`、`Ant`、`Maven` 等配置

--------------------

参考文献：

安装 Jenkins：[https://www.jenkins.io/zh/doc/book/installing/][https_www.jenkins.io_zh_doc_book_installing]

Windows 上安装 Jenkins 教程：[https://segmentfault.com/a/1190000019730287][https_segmentfault.com_a_1190000019730287]

[https_www.jenkins.io]: https://www.jenkins.io
[https_www.jenkins.io_zh]: https://www.jenkins.io/zh/
[808b30634d244aa2a14b7a34174e23fd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/332cc5f4fa1548039ad0eb0efa18efce.png
[41c8d88ba6034707af5cf9fece64049f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/c4222bd29f65462c958b7c33978438c1.png
[Java-]: https://blog.csdn.net/xhmico/article/details/122390181
[Link 1]: https://www.jenkins.io/download/
[bd3232e561ed44379e45f8f2766a3477.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/fc6d4a6a9486485eb814c0aea1f6fedd.png
[Jenkins-Java Support Policy]: https://www.jenkins.io/doc/book/platform-information/support-policy-java/
[4cf561c5a37a4888b95c7e17229efc08.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/d987f7efcdf94e8394a019325ab57046.png
[542c1e0f14c243f8bd35189634293842.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/fe190f8ef5b349828109b9dfca78f697.png
[bff229f4787a44f6b94ad8903effb915.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/a467b5154f1c4f778703d79a21dbedb3.png
[2b81914134034ff5b7c8e6edbb343999.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/d321d2c7284b48aeaa75ee80b4bef35c.png
[1d5f8f695df6457ca1e67e5c7660c231.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/ab4aa5ff461b4f9eb617fb3ead07a4a1.png
[b7ad962325c34259ad5e70fd3c63a97c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/6f74126414ef4fe2886b91bb5fbd0f26.png
[3fbb4c9fdb7a4d198aee3b0009b6f216.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/17fa7e1f295d487bbe9817dbe624b74c.png
[Tomcat]: https://blog.csdn.net/xhmico/article/details/136392893
[72350193813940389cf55d99c7f03105.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/683e0d8953e9452291040f5d74e89791.png
[http_localhost_8080_jenkins]: http://localhost:8080/jenkins
[0fc525f24d344a6b9e3575bed775fa2e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/094c99d2ede643719f12bf5be689bb32.png
[3127bbaa9f6b4536a56294a1b8e98893.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/7c761b79a09843a5bea9cfe938f44397.png
[813b03f24f374cda835e01761ac494cf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/e81de0608e8e491bae49cf89b7b760f3.png
[c981e7ffbf6549089f4d7b5fca2903bf.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/11c6fe54e99340ab83018314dcdf22b5.png
[d05f32907f464f339817c2d833e322bc.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/55bb18b9f80642ddaef81d1701e287e1.png
[f14b32cf7a914884b418d0eb033a087d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/ee8860246af640cf9fd4d4c10d8115c8.png
[5fc2406249ad468183edc743bb9b8ec5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/eb302ebd6f2f484cac76dacf058e09b2.png
[692a88f00ad247aaa39c3060cb730a1f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/75c1b35a2c154508bd79dd8dca824b0d.png
[85bae27b11f4420983477aa4f73cfffe.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/66d1d93606dd4c12830bbc2cba4b5a59.png
[38f59b27faf647a18d0ffec3580c07fe.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/95ca29fdc72849d4b05e9155a4c743c8.png
[3652cac8bdf04d0aaf00e110044d47a5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/fa30c24db8ad4587952dabcab7908aff.png
[localhost_8080]: http://localhost:8080/
[4465df09adaa43c892dcbebec3b93683.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/07d3a19f627e416cba0ad6420c0b9e88.png
[d8afb9f771f64b559ba20db6a8eb22db.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/32e2cbf78c594e07b8de8f4db8c65cc8.png
[82ea638ba6de464fbea03244f52096e3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/1f3a0e2206f049c89ba00fbf99b7942d.png
[96dbd60eac114dbe834da57c287bc798.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/3689db7e2c1f4655bc317fad4d929191.png
[b9175024cd9f48ca994d31fba8cbf657.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/ffd2a67df03b4a2f91097ea131157228.png
[2552677cd2384cbc84dee4b958a08abc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/31d8e38995444ce0985e6ca1529f811e.png
[807a816ae66c4795b31ff2ec80d032de.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/790745683ff84e829a7965faad200305.png
[6b5f656ab3324afbbb5495dee6ccc7af.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/bd717ccd0b7d41adbda53f29829e66e6.png
[1ee2867f111b4d868ff699a698307163.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/e0035c00cf004ee790d17573eb6a2da1.png
[31008261ea6847daba3615bb6e286c5d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/18677821c55b4371827479b336fd25d8.png
[Link 2]: https://mirrors.tuna.tsinghua.edu.cn/
[Link 3]: https://mirror.xmission.com/
[6b8d29ff55ff4da1a4ca2ceaf457ce71.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/fc7236dfeb4d45818502d13a5d271a1d.png
[86b499d9d5df4dcca9f5c2c577e2285d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/9199f179ce4f4a52b88a20144a2c172c.png
[84510f4871874e418a193fa23ccc807e.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/6de937acf42f445581dbc354d4878ee6.png
[14925ec7d77b4289a8c446645931397b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/484f23c0ba4c4ef39c51d9bb68e80c29.png
[5f600eef21dd443bba70246a86c491fb.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/af6d382efb1f4259924566f67a2321da.png
[7f8c991d1ce34bfab97e00e2979a3484.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/6503ceba6070473b806b3e34ef1bdfbd.png
[1f7aa079996e4e0aab29de874b72ebe1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/1330bffe9eef4370bdeceadf026f2386.png
[6767a5c6eef54c53a4ca007021f1cb41.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/a7c99ce56aef4dce8135a5c623c2b529.png
[45afeb6d7b0f4971863251e1f2a192f0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/e9c28b3fa5324198845c49183acf68f3.png
[b6d9214a391543d0946f2aebf7a17206.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/65e1090ec78a4618afb8bd8246ea24f7.png
[https_www.jenkins.io_zh_doc_book_installing]: https://www.jenkins.io/zh/doc/book/installing/
[https_segmentfault.com_a_1190000019730287]: https://segmentfault.com/a/1190000019730287