搭建一套基于Docker Jenkins CI CD devOpts环境

约定不等于承诺〃 2023-07-07 11:17 8阅读 0赞

## 0.前言 ##

在互联网时代，对于每一家公司，软件开发和发布的重要性不言而喻，目前已经形成一套标准的流程，最重要的组成部分就是持续集成（CI）及持续部署、交付（CD）。本文基于Jenkins+Docker+Github实现一套CI自动化发布流程。  
  本文想介绍下，对于没有接触过CI，CD的同学，如何基于Jenkins+Docker+Github搭建一套自动化发布流程，本文会以一个简单Java Web项目为例子，每次Push代码到github上，jenkins都会重新拉取代码，并跑完UT IT测试，然后将最新的war包构建好，发布到docker的容器上。

![format_png][]

image.png

## 1. 环境搭建 ##

1.1 Docker安装

我的环境是CentOS7.5，首先在server上安装Docker。具体步骤可以参照以下文章：  
[Docker入门安装使用教程 ][Docker_]

1.2 Jenkins安装

1.  docker 安装jenkins非常方便执行下面的脚本就OK了

> docker run --name devops-jenkins --user=root -p 8080:8080 -p 50000:50000 -v /opt/data/jenkins\_home:/var/jenkins\_home -d jenkins/jenkins:lts

1.  registry安装，做这一步的目的是作为开发者， 自然会自己制作一些镜像， 在公司内网分发， 或者开发团队制作镜像， 然后交付给测试团队进行测试， 这就需要一个内部分发镜像的服务器， 这个 Docker 团队自然也想到了， 并且提供了一个镜像 [retistry][] ， 先把这个镜像拉倒本地

> docker run --name devops-registry -p 5000:5000 -v /opt/devdata/registry:/var/lib/registry -d registry

1.  启动完jenkins后通过浏览器输入地址：

> http://部署jenkins主机IP:端口

1.  根据提示从输入administrator password 或者可以通过启动日志

> docker logs devops-jenkins
> 
>  
> 
> ![format_png 1][]
> 
> image.png

1.  进入插件安装界面，连网等待插件安装，安装完插件后，进入创建管理员界面，输入完管理员账号后，点击continue as admin 就安装完成了，如果需要安装一些自己想要的插件，则可以Manage jenkins=>Manage Plugin进行修改。
    
     
    
    ![format_png 2][]
    
    image.png

1.3 Java 项目介绍

这个就不详细介绍了，就是利用Eclipse简单的建了一个简单的Maven（Spring Boot）项目，包含了一个简单的Controller和UT，IT测试case，项目结构如下：

![format_png 3][]

image.png

Github地址如下：[https://github.com/Syfhehe/CI-CD-Demo][https_github.com_Syfhehe_CI-CD-Demo]

## 2. Jenkins Pipeline ##

2.1 Jenkins Pipeline 打通 Github集成的桥梁。

1.  Maven配置  
    进入Jenkins-->Global Tool Configuration，添加一个Maven。

![format_png 4][]

image.png

1.  进入Github --> Setting -->Develper Settings --> Personal Access Token --> Generate new token，生成一个新的Token。
    
    ![format_png 5][]
    
    image.png
    
      
    自己先保存此`token`，如果丢失，之后再也无法找到这个`token`。

![format_png 6][]

image.png

3.为了让Pipeline捕获仓库中的事件（例如push），应该在GitHub上正确设置Jenkins GitHub webhook。

在Payload URL中设置xxx/github-webhook/，如下所示：

![format_png 7][]

image.png

1.  登录Jenkins，进入系统管理 --> 系统设置 --> GitHub --> Add GitHub Sever，添加一个Github Server
    
    ![format_png 8][]
    
    image.png
    
      
    API URL 输入 [https://api.github.com][https_api.github.com]，Credentials点击Add添加，Kind选择Secret Text,具体如下图所示。
    
    ![format_png 9][]
    
    image.png
    
      
    设置完成后，点击`TestConnection`,提示`Credentials verified for user UUserName, rate limit: xxx`,则表明有效。

2.2 建立一个Github有push事件， Jenkins Pipeline 就会自动运行的Jenkins Item

1.在我们之前建的Java项目的Git仓库的根目录创建并保存一个名为 Jenkinsfile 的文本文件。  
复制以下声明式流水线代码并粘贴到 Jenkinsfile 文件中：

pipeline {
       agent any
    
       stages {
           stage ('Compile Stage') {
    
               steps {
                   withMaven(maven : 'Maven-3.6.1') {
                       sh 'mvn clean compile'
                   }
               }
           }
    
           stage ('Testing Stage') {
    
               steps {
                   withMaven(maven : 'Maven-3.6.1') {
                       sh 'mvn test'
                   }
               }
               post {
                   always {
                       junit 'target/surefire-reports/*.xml' 
                   }
               }
           }
           
       }
    }

2.在Jenkins上创建一个Pipeline。名字随便。

![format_png 10][]

image.png

3.勾选GitHub hook trigger for GITScm polling ，这样每次push就会执行一遍jenkinsfile的脚本。

![format_png 11][]

image.png

如果希望pipeline执行Jenkinsfile的脚本，还需进行以下设置，这里的Credentials就是在上一章生成的。

![format_png 12][]

image.png

1.  保存退出，然后随便push一点修改到github，你就会发现Jenkins Pipeline会自动build。
    
     
    
    ![format_png 13][]
    
    image.png

5.这样CI-CD的前半部分：CI，就算完成了。

To Be Continue.....

from：https://www.jianshu.com/p/f087e78aac45

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTczOTgwNjI0ZTM2ZWY3ODcucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTAyNC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[Docker_]: https://www.jianshu.com/p/ecb1e0eb0514
[retistry]: https://links.jianshu.com/go?to=https%3A%2F%2Fhub.docker.com%2Fr%2Flibrary%2Fregistry%2F
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWMzZDVhOTNmM2RhMzlmMTQucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvODQ0L2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTdlM2ViNjZmMmI4OTI0M2MucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTIwMC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWExMmUzMjM1NmIzNmVlNjIucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMzMxL2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[https_github.com_Syfhehe_CI-CD-Demo]: https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2FSyfhehe%2FCI-CD-Demo
[format_png 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTlhYjI1ZWU5YWJkNTQyMjkucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTIwMC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTZlMTY4MGRhOWFkM2Y5MjkucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvODgzL2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[format_png 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTc2YmFiZjU4MWE5YThiM2IucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvNzM0L2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[format_png 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWViMTliZmZlZTM2NGVhMGQucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvNzQxL2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[format_png 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWVjOGY5MmQ1N2FhNTk0NGEucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvOTczL2Zvcm1hdC93ZWJw?x-oss-process=image/format,png
[https_api.github.com]: https://links.jianshu.com/go?to=https%3A%2F%2Fapi.github.com
[format_png 9]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWFhMGMxZDFjOTBiNzIyOWYucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTAzMS9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 10]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTI2MTc4ZmFjODljN2ZlNjEucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTIwMC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 11]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWIzZDYzM2ZhYjBhNDlhMmUucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTIwMC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 12]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLTUxMmQwODI2NWY5MDAyNDgucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTIwMC9mb3JtYXQvd2VicA?x-oss-process=image/format,png
[format_png 13]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTc3NTMzLWEzZjAyMmM3NmFjNzljMjQucG5nP2ltYWdlTW9ncjIvYXV0by1vcmllbnQvc3RyaXB8aW1hZ2VWaWV3Mi8yL3cvMTA5MS9mb3JtYXQvd2VicA?x-oss-process=image/format,png