Jenkins安装与使用(二)

ゝ一世哀愁。 2022-12-08 15:52 198阅读 0赞

[Jenkins安装与使用(一)][Jenkins]

### 文章目录 ###

*  3. 添加项目
 *   *  3.1 添加凭证-配置git
     *   *  3.1.1 添加凭证
         *  3.1.2 验证
     *  3.2 添加全局变量-配置jdk和maven
     *   *  3.2.1 添加配置
         *  3.2.2 验证
     *  3.3 发布
     *   *  3.3.1 项目配置
         *  3.3.2 验证
     *  3.4 总结

# 3. 添加项目 #

> 首先，我们捋一遍持续集成的流程：
> 
> 1.  开发人员提交代码，到git仓库；
> 2.  jenkins作为持续集成工具，使用git工具到git仓库拉取代码到服务器上；
> 3.  配合jdk,maven等工具完成代码的编译，测试，打包等工作；
> 4.  jenkins把生成的jar包或war包分别发送到不同的服务器上，部署发布。

## 3.1 添加凭证-配置git ##

### 3.1.1 添加凭证 ###

凭据可以用来存储需要密文保护的数据库密码、Gitlab密码信息、Docker私有仓库密码等，以便 Jenkins可以和这些第三方的应用进行交互。

1.  首先，要在Jenkins使用凭证管理功能，需要安装Credentials Binding插件，安装完成后会出现凭证管理的菜单。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center]
2.  点击进入后，添加凭证，可以看到类型是有物种不同的类型。第一种用户名和密码和第二种ssh是最常见的两种方式。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 1]
3.  我们在这里演示添加一个凭证。即：从git仓库拉取代码，首先确保已经在jenkins上安装了git插件，以及在jenkins所在的服务器上也安装了git工具。（git插件只是在添加项目时源码管理的地方可以选择git，实际上当我们点击构建项目时，是服务器上的git工具自动拉取代码到工作目录下）  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 2]
4.  用git的用户名和密码创建凭证，用户名和密码不必多说，id可以不用填写会自动生成，描述是为了使用时能分辨清楚；点击完成创建成功。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 3]
5.  添加成功后，在创建项目时，就会在源码管理这里看到我们添加的git凭证。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 4]

### 3.1.2 验证 ###

1.  我们这里先只拉取代码，验证一下git是否配置成功。创建完成后点击**立即构建**，在下方可以看到**构建历史**，点进去可以在控制台看到拉取代码的日志，说明我们已经配置成功。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 5]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 6]
2.  日志的第三行`Building in workspace /usr/local/jenkins/workspace/test01`，这个就是我们拉取到代码的路径，前面是我们jenkins的工作目录，后面是我们项目的名称，所以我们也可以在服务器对应的目录上看到拉取的代码。  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 7][]

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

## 3.2 添加全局变量-配置jdk和maven ##

### 3.2.1 添加配置 ###

> 我们之前已经在Jenkins所在的服务器上安装好了maven和jdk。

现在我们还需要在Jenkins的系统配置中添加一些全局变量，这里的配置让Jenkins可以感知到maven的这些命令。

**系统配置 -> 全局属性 -> 环境变量**

添加的环境变量如下：**JAVA\_HOME、M2\_HOME、PATH+EXTRA**（在之前的PATH环境变量的基础上追加新的环境变量）  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 8]

### 3.2.2 验证 ###

1.  我们在此验证一下刚才的操作，刚才添加的项目test01点开配置
    
    **构建 -> 添加构建步骤 -> 执行shell**，输入如下命令：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 9]
2.  点击构建，查看控制台输出的日志，可以看到构建成功，说明我们配置的没有问题；同时，也可以在Jenkins服务器的workspace目录下看到我们打包成功了。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 10]  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 11][]

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

## 3.3 发布 ##

至此，我们已经完成了项目的构建步骤，只剩下最后一步，把打的jar包或其他的包分配到指定的服务器下，然后部署。

> 这里首先介绍一个Jenkins的环境变量$WORKSPACE，这个变量的定义是`The absolute path of the directory assigned to the build as a workspace.` 那么它指的路径到底是什么呢？我们可以创建一个项目验证一下。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 12][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 13][]

> 可以看到$WORKSPACE的路径就是我们之前在安装Jenkins时说过的JENKINS\_HOME/创建项目名称，也就是我们代码的根目录，之后在项目配置时写的相对路径也是从这个地方开始的。

### 3.3.1 项目配置 ###

1.  下载一个插件**Publish Over SSH**，这个插件可以把指定的文件发送到其他服务器的制定目录下，并执行一些操作。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 14]
2.  我们需要将包发送到一个测试服务器上，那么就一定需要将这个测试服务器的信息配置到Jenkins上。  
    **系统管理 -> 系统配置 -> Publish Over SSH**，配置信息如下：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 15]

> 1.  Publish over ssh -> SSH Servers -> 新增；
> 2.  Name：为了区分不同的服务器，自由命名
> 3.  HostName：服务器的地址
> 4.  Username：服务器连接的用户名
> 5.  Password：服务器连接的密码
> 6.  Remote Directory：服务器的目标路径，我们将文件发送到的路径
> 7.  底下可以点击Test Configuration，测试我们的配置是否可以成功连接上，注意：如果Remote Directory指定的路径服务器上不存在，测试结果也是会失败的。测试成功，点击保存。

1.  打开我们之前创建的项目，继续编辑配置。  
    **增加构建步骤 -> Send file or execute command over SSH**  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 16][]  
    jar包路径：  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 17][]  
    配置：  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 18][]

> 1.  Name 是我们之前配置的测试服务器的名称，如果之前配置了多个服务器，在这里可以做出选择；
> 2.  Source files：jar包的路径，这里可以写相对路径
> 3.  Remove prefix：发送文件需要移除的路径，举个例子，我们的jar包的路径是$WORKSPACE/springboot/target/\*\*\*.jar
>     
>     那如果我们这里不配置，文件发送到指定服务器后前面的 springboot/target 也会一起被复制过来，显然我们是不需要这个前缀的，所以需要移除这个路径。
> 4.  Remote directory：发送文件的目标路径，与前面配置的路径结合在一起；因此，我们这个配置中目标路径是/app/myspringboot
> 5.  Exec command：这个是可执行的命令，可以写一些脚本，在将文件发送到测试服务器后，在测试服务器上执行此处添加的命令。
>     
>     这里简单说明下的我写的脚本的意思：首先是得到这个项目的pid，如果项目之前已经部署过了，需要先杀掉这个进程；接下来是java -jar启动jar包，然后等待30秒，再次查看pid，如果启动成功了就会有新的pid，如果没有说明启动失败了。

### 3.3.2 验证 ###

至此，我们已经配置完成了，点击立即构建，可以在控制台输出查看到最终的构建结果。

1.  在Jenkins的构建历史中，可以看到对应的控制台日志中的输出结果。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 19]
2.  在对应的服务器上看到复制的文件和已部署的进程信息，这也说明我们的操作是成功了的。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 20]

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

## 3.4 总结 ##

至此，我们已经初步完成了Jenkins的配置和使用，在以后的开发中，当我们提交完代码后，只需要在Jenkins上点击一下构建，就可以完成自动构建部署等操作，是不是非常方便呢？  
当然，Jenkins还有很多其他的功能和插件，比如构建触发器、邮件服务、用户权限管理等等，以后有机会在继续学习。

[Jenkins]: https://blog.csdn.net/wei_cheng18/article/details/108209176
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/d4e4941e5f65472d8b75bd4f8c32fdfa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/8ca58960d5fc4132a28e5a61a72f1847.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/4c30f2da345540c28ba97791761d959c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/ed5a6758cda84d09b4e8b25ffbfaef0c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221123/293bdb4f823246faae6f8c616615d345.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221123/2832fed7df52451ba8591f580fb59284.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221123/c78431e231ab43e5b3d7bc46a673d367.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221123/9d88d98673fd41dbbf24c00e0ce9bf4b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221123/45173920bd184ab19c9de3720b80c28a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221123/5e4ff19363f94d0194b38880685f5e5a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221123/194e345e1af84b34a5a764aa24e7c29e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 11]: /images/20221123/057152e7eb774ddc9f3e70a5813208cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 12]: https://img-blog.csdnimg.cn/20200923230357624.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 13]: /images/20221123/8644c06464124910b169b3667728c7cc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 14]: /images/20221123/db8dc1938c5d4f43bd4743707b66dda7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 15]: /images/20221123/8ac1f10e22e94de1a2a42d75cf613ad2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 16]: /images/20221123/2651acfd3b3a4f0284d130474a181a13.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 17]: /images/20221123/a8e2ce13d81142468e1784300634de92.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 18]: /images/20221123/f52ffc8ba2814b7f930c4598a7f91b42.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 19]: /images/20221123/c571f8d2df024e7cb158c2b2c237ba60.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaV9jaGVuZzE4_size_16_color_FFFFFF_t_70_pic_center 20]: /images/20221123/7e1dd37023ca44169f3be18e087ed9db.png