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

0.前言

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

image.png

1. 环境搭建

1.1 Docker安装

我的环境是CentOS7.5，首先在server上安装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

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

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

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

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

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

docker logs devops-jenkins

image.png

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

   
   
   

   image.png

1.3 Java 项目介绍

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

image.png

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

2. Jenkins Pipeline

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

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

image.png

2. 进入Github --> Setting -->Develper Settings --> Personal Access Token --> Generate new token，生成一个新的Token。
   
   

   image.png
   
   自己先保存此token，如果丢失，之后再也无法找到这个token。

image.png

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

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

image.png

4. 登录Jenkins，进入系统管理 --> 系统设置 --> GitHub --> Add GitHub Sever，添加一个Github Server
   
   

   image.png
   
   API URL 输入 https://api.github.com，Credentials点击Add添加，Kind选择Secret Text,具体如下图所示。
   
   

   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。名字随便。

image.png

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

image.png

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

image.png

4. 保存退出，然后随便push一点修改到github，你就会发现Jenkins Pipeline会自动build。

   
   
   

   image.png

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

To Be Continue.....

参考文档：

• How to create Jenkins Pipeline with an Example | Pipeline as Code | Tech Primers
  
• 使用Maven构建Java应用程序
• 手把手教你搭建Jenkins+Github持续集成环境