Jenkins + Pipeline 自动化部署项目

先上总结

Pipeline可以很方便实现流水式的持续交付,执行阶段通过视图一目了然。更多详细的资料可以访问官方文档

pipeline官方介绍

网上关于Jenkins Pipeline的资料混乱,没有完整例子,现在我把这段时间的学习总结出来,供大家参考。如有错误敬请谅解。

1.CICD

以下是网上有关CICD的介绍

什么是持续集成(CI-Continuous integration)

持续集成是指多名开发者在开发不同功能代码的过程当中,可以频繁的将代码行合并到一起并切相互不影响工作。

什么是持续部署(CD-continuous deployment)

是基于某种工具或平台实现代码自动化的构建、测试和部署到线上环境以实现交付高质量的产品,持续部署在某种程度上代表了一个开发团队的更新迭代速率。

什么是持续交付(Continuous Delivery)

持续交付是在持续部署的基础之上,将产品交付到线上环境,因此持续交付是产品价值的一种交付,是产品价值的一种盈利的实现。

CICD优点

降低成本,提高生产力,高可用,更可靠,性能优化

如何做到持续集成和持续交付可以网上参考其他资料,这里不再多说。


Jenkins:

优点:编译服务和代码仓库分离,而且编译配置文件不需要在工程中配置,如果团队有开发、测试、配置管理员、运维、实施等完整的人员配置,那就采用jenkins,这样职责分明。

缺点:配置相对复杂,维护成本较高等

其实最重要的还是使得不同职能的人员分工明确,让每个人知道自己现在要做什么,下一步应该做什么。

对于开发人员,他们需要提交代码到自己的开发分支,在开发分支上自动构建部署自行测试通过,然后合并到测试环境分支继续测试。测试分支ok之后合并分支到生产基线分支,基线环境构建后测试,通过后正式宣布上线。

对于运维人员,他们仅需要管理服务器状况

测试人员职责不变

开发人员在发布版本时,仅需要打开对应的流水线点击构建,构建信息可以实时打印,以便排查错误。

运维人员不再需要每次拷贝文件到服务器以及管理各种启动脚本和配置文件,减少出错的概率。

image
image
image

2.环境搭建

2.1 准备阶段

涉及到的工具包

①Jenkins ②Git ③Docker ④JDK ⑤Maven /Gradle

pipeline插件对jenkins版本有要求,最好安装一个版本较新的

安装过程略...

并行构建的量不大的情况下不建议使用docker安装Jenkins,直接把Jenkins安装到宿主机即可,不然要面临各种目录挂载和环境变量的问题

厉害的当我没说

2.2 配置阶段

jenkins配置较为复杂,以下细看再进行操作。

  1. 安装完毕jenkins后,vi /etc/sysconfig/jenkins,把jenkins的执行用户改成root(或者你正在用的用户名),也可以不改,给系统新增一个jenkins用户也是可以的。
image
  1. 启动systemctrl start jenkins,然后访问对应ip,默认端口是8080,也可以在刚才的文件中修改JENKINS_PORT

  2. vi /var/lib/jenkins/secrets/initialAdminPassword(
    

默认目录,如有修改请改成对应的jenkins home的目录下,找到secrets/initialAdminPassword),可以看到初始密码,复制拷贝到网站上即可登陆并创建你的初始用户

  1. 安装插件界面,如果你什么都不知道,请直接选择第一个,安装推荐的插件,这样会把中文等各种插件安装好
image
  1. 安装插件可能失败,大概率是因为网络原因,所以这里修改一下插件的安装镜像地址。

打开 系统管理->插件管理->高级->升级站点,改成清华大学的镜像地址

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

image

6. 配置全局工具

系统管理->全局工具配置

注意!如果你是通过docker安装的jenkins,请把对应的目录挂载到Jenkins容器再配置,否则会报找不到

注意!这里配置的工具别名(name)待会在pipeline脚本中是有用的,并不是乱写的

image
image

7. 接下来是首页,新建任务

选择流水线或者多分支流水线。

区别在于分支的管理,流水线pipeline是单分支,多分支就是字面的意思可以管理多分支

这里我选择多分支流水线(如果没有这个选项,请自行百度要安装哪个插件,一般安装了推荐插件都会有

image

8. 配置流水线

这里配置的是分支的来源

image

如果没有凭证,可以新增一个

image

构建配置这里,尽量不要改动,这里的意思是根据分支根目录下的Jenkensfile文件来自动配置流水线

image

保存确定后,就会看到Jenkins在扫描gitee上的分支,然后创建3个分支流水线,但是因为还没有写jenkinsfile文件,所以流水线里面是空的

image

到这里jenkins的配置就完成了,准备进入pipeline脚本编写阶段

3. pipeline脚本

3.1 编写pipeline脚本

image

pipeline遵循Groovy语法,熟悉的人可能很快掌握,不熟悉也没关系,可以通过流水线语法生成器生成,我们拷贝回去就行。语法这里不说,以后可能专门讲,以下是学习地址:Jenkinsfile学习

image
image
解释一下这里的意思,这里定义了三个stage,也就是3个流程,第一步从git拉取对应的分支代码,第二步使用maven构建包,第三步给脚本授权并执行脚本。每一个流程如果失败不会进入下一步。

3.2 编写docker脚本

docker build脚本对应Dockerfile(大小写要完全一致)

Dockerfile学习

语法这里不说,给出示例

image

3.3 编写自动部署脚本

这里的自动化部署脚本就是因人而异了,每个人的项目情况不同,可能要部署前端后端,还要推送到其他服务器等等,都可以通过脚本实现

给出一个自己写的shell脚本示例


#!/bin/bash

JOBMS=$1

VERSION=latest

JOBREPO=/data/docker/$1

IMGREPO=xmbaby-test

IMGNAME=$1

DTIME=`date+%Y-%m-%d" "%H":"%M":"%S`

TAG=$2

CONTAINER_NAME=rest-mvc

BRANCH=$3

if[!-d$JOBREPO];then

    echo-e"jar目录不存在,将创建jar目录\n"

mkdir-p$JOBREPO

cp/var/lib/jenkins/workspace/$JOBMS_$BRANCH/target/$JOBMS.jar$JOBREPO/

echo-e"jar已经复制到待创建镜像目录中,等待构建docker镜像\n"

else

    echo-e"时间$DTIME,开始构建docker镜像\n"

fi

echo-e"构建docker镜像前,删除之前的容器、镜像."

IMAGE_ID=`docker images |grep$JOBMS|awk'{print $3}'`

echo"Image镜像ID:$IMAGE_ID \n"

CONTAINER_ID=`docker ps-a|grep$CONTAINER_NAME|awk'{print $NF}'`

echo"Container容器:$CONTAINER_ID \n"

if[-z$CONTAINER_ID];then

    echo-e"不存在容器,跳过清理容器阶段\n"

else

    dockerrm-f$CONTAINER_ID|true

    echo-e"$CONTAINER_ID 旧容器删除成功!"

docker rmi-f$IMAGE_ID|true

    echo-e"$IMAGE_ID 旧镜像删除成功!"

fi

echo-e"时间:$DTIME,正式开始构建docker镜像"

docker build-t$JOBMS:$TAG.

if[$?-ne0];then

    echo-e"时间:$DTIME,$JOBMS 镜像构建失败,请检查Dockerfile !"

exit

else

    echo-e"时间$DTIME,开始运行Docker容器."

#docker run --name $CONTAINER_NAME -v $JOBREPO:$JOBREPO -d -p 8081:8081 b2b-partner-img/$JOBMS

docker run--name$CONTAINER_NAME-d-p8080:8080$JOBMS

sleep 5

IMAGEID_NEW=`docker images |grep"$JOBMS"|awk'{print $3}'`

echo"新镜像ID:$IMAGEID_NEW"

CONTAINERID_NEW=`docker images |grep"$JOBMS"|awk'{print $1}'`

echo"新容器ID:$CONTAINERID_NEW"

fi

项目文件路径

image

一个jar包部署到docker当然没有优势,但如果是大批量应用部署,或者前后端代码好几个包,还有很多文件需要配置或者删除等等,通过docker就很方便了,即使失败了还可以恢复备份好的docker镜像,不会导致不可用。

简单的一个包可能都不需要使用Jenkins

未完待续/doge