最优雅的Docker+Jenkins pipeline部署Spring boot项目

使用Jenkins发布项目已经4年多，作过屡次改进，尽可能减小Jenkins的配置和发布脚本的书写。从最初的构建一个自由风格的软件项目到流水线项目到如今的流水线+docker，流水线可让项目发布流程更加清晰，docker能够大大减小Jenkins配置。

下面带你们使用最简单，最快速的方式使用Jenkins，无需配置git、maven、jdk、node等环境，一切用docker搞定，只须要写脚本，其余无需配置

此教程仅为进阶教程，具体的jenkins安装，git凭据配置，邮件发送等须要自行查找教程进行配置。

本教程使用的环境

• centos7
• docker-ce 18.09.1(务必使用docker-ce，老版本的docker会致使Jenkins中没法使用docker daemon)

准备工做

安装docker

yum install docker-ce

配置docker加速器（可选）

不少厂商都提供docker加速服务，好比阿里云，腾讯云 详情请自行百度。不配置国内加速器，下载镜像可能很缓慢。

使用docker安装Jenkins

docker pull jenkins/jenkins，切勿docker pull jenkins已经废弃

Jenkins docker hub地址

启动Jenkins

docker run -u root -itd --name jenkins -p 6001:8080 -v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime:ro -v /volume1/docker/jenkins:/var/jenkins_home jenkins/jenkins
复制代码

启动命令含义

-p 6001:8080Jenkins默认网页访问端口为8080，将端口映射到外部主机

-v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock使Jenkins内部可使用docker命令

-e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime:ro配置Jenkins容器的时区

-v /volume1/docker/jenkins:/var/jenkins_home 将Jenkins的配置映射到外部主机卷，容器删除仍可保留配置

进入Jenkins容器内部，判断docker命令是否正常执行

docker exec -it jenkins bash

docker info

可能须要安装libltdl7，若是须要执行如下命令

apt-get update

apt-get install -y libltdl7

配置Jenkins

http://主机IP：6001可访问Jenkins网页端，其余流程忽略，所有默认就能够。

无需配置git、maven、jdk、node等环境，咱们使用docker解决

新建一个流水线项目

关于流水线脚本书写，有两种写法，官方文档

Using Docker with Pipeline，官方文档

编写脚本

分享我本身项目的发布脚本，适用于spring boot项目，细节须要本身修改。此脚本须要使用Dockfile，参考下一节

import java.text.SimpleDateFormat
node {
    try {
        //名字这么写是为了能够发布到腾讯docker仓库，可随意更改
        def dockerId='tengxun'
        def dockerUrl='ccr.ccs.tencentyun.com'
        def dockerNamespace='esms'
        def dockerName='esms-api'
        def env='test'
        
        def dateFormat = new SimpleDateFormat("yyyyMMddHHmm")
        def dockerTag = dateFormat.format(new Date())
        
        stage('git pull'){
            sh 'pwd'
            git credentialsId: '此处填写git凭证，须要在Jenkins凭据中配置', url: '此处填写git地址'
        }
        stage('mvn install') {
            sh 'pwd'
            docker.image('maven:3.6.0-jdk-8-alpine').inside('-v /volume1/docker/.m2:/root/.m2') {
                sh 'mvn --version'
                sh 'mvn clean install'
            }
        }
        stage('docker run') {
            dir("esms-main") {
                sh 'pwd'
                def imageUrl = "${dockerUrl}/${dockerNamespace}/${dockerName}:${dockerTag}"
                def customImage = docker.build(imageUrl)
                sh "docker rm -f ${dockerName} | true"
                //--network esms-net配置网络信息，须要先docker network create esms-net，用于多个服务交互，可选
                customImage.run("-it -d --name ${dockerName} -p 8090:8090 --network esms-net -e SPRING_PROFILES_ACTIVE=${env}")
                //only retain last 3 images，自动删除老的容器，只保留最近3个
                sh """docker rmi \$(docker images | grep ${dockerName} | sed -n '4,\$p' | awk '{print \$3}') || true"""
            }
        }
        currentBuild.result="SUCCESS"
    } catch (e) {
        currentBuild.result="FAILURE"
        throw e
    } finally {
        //此处若想发布邮件，须要在系统管理-系统设置中配置邮件服务器
        mail to: 'xxxx@qq.com',subject: "Jenkins: ${currentBuild.fullDisplayName}，${currentBuild.result}",body:"${currentBuild.result}"
    }
}
复制代码

最终发布之后docker images查看，名称格式相似以下，如使用上面的代码发布后名称为

ccr.ccs.tencentyun.com/esms/esms-api

Sprint Boot项目结构以及Dockerfile

Dockerfile书写，仅作参考，具体根据本身项目结构

FROM openjdk:8-jdk-alpine

MAINTAINER liunewshine@qq.com

ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone && mkdir -p /esms

WORKDIR /esms

EXPOSE 8090

ADD ./target/esms.jar ./

CMD java -Djava.security.egd=file:/dev/./urandom -jar esms.jar
复制代码

发布项目

直接构建便可，未作git的webhook，不能联动git push等，有需求的能够本身加上

总结

整体过程很简单，主要就是安装Jenkins->编写pipeline脚本->编写Dockerfile脚本。