基于Docker+Jenkins+Gitlab搭建持续集成环境

缺乏、安全感 2022-05-16 13:17 509阅读 0赞

最近使用docker+jenkins+gitlab搭建了持续集成环境，原理如下图所示（没有画图，引用了[http://www.jianshu.com/p/358bfb64e3a6][http_www.jianshu.com_p_358bfb64e3a6]的图）：

随着DevOps理念和敏捷理念的发展，我们希望通过自动化技术，加快项目的迭代。尤其是当使用微服务方案后，面临在大量的项目构建和部署工作，借助于jenkins的持续集成，可以快速把应用打包成docker镜像，实现自动部署。

![Image 1][]

持续集成.png

如图演示了以下的场景：

*  开发者向自己的gitlab网站提交了代码
 *  jenkins通过定时任务检测到了代码有变成，执行自动化构建过程
 *  jenkins在自动化构建脚本中调用docker命令将构建好的镜像push 私有镜像注册中心
 *  同时，jenkins也可以直接执行remote shell启动构建好的容器
 *  构建失败或者成功，可以及时将结果推送给相关人员，比如测试人员，安排测试
 *  服务端可以手动通过docker命令，从镜像仓库中心拉取镜像，进行手动部署

我搭建的环境都是在本地，gitlab、jenkins、docker私有仓库都部署在本地，以下是操作步骤：

## 搭建docker私有仓库 ##

使用docker拉取registry镜像，然后启动容器

docker run -d -p 5000:5000 -v ~/docker-registry:/tmp/registry registry

这样就可以在本地运行一个私有镜像注册中心，通过镜像名称前缀127.0.0.1:5000可以将镜像推送到这个地址

## 搭建gitlab ##

拉取gitlab镜像，并启动

docker pull gitlab/gitlab-ce

sudo docker run --detach \
    --hostname gitlab.bill.com \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --name gitlab \
    --restart always \
    --volume ~/gitlab/config:/etc/gitlab \
    --volume ~/gitlab/logs:/var/log/gitlab \
    --volume ~/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce:latest

因为部署在本地，又指定了gitlab.bill.com作为域名，所以在/etc/hosts配置下，这样可以通过域名访问gitlab。

127.0.0.1 gitlab.bill.com

初次登录可以修改密码，或者重新注册一个用户，我注册了一新用户，并在gitlab中创建了一个demo项目

![Image 1][]

demo.png

创建了一个空项目后，然后根据github上的提示，将本地的git项目推送到gitlab

![Image 1][]

Gitlab\_http.png

上传完后Gitlab项目如下：

![Image 1][]

Demo sourcecode.png

## 搭建jenkins ##

**安装jenkins**  
使用docker 下载jenkins镜像 jenkinsci/jenkins,并启动

docker run \
    -p 8080:8080 \
    -p 50000:50000 \
    --name jenkins \
    --link gitlab:gitlab.bill.com \
    -u root \
    -v ~/jenkins:/var/jenkins_home  \
    -v /usr/share/maven:/usr/local/maven \
    -v /usr/lib/jvm/jdk1.8:/usr/local/jdk \
    -d \
    jenkinsci/jenkins:latest

8080端口是jenkins的端口，5000端口是master和slave通信端口（没错，jenkins可以部署集群,在本次中没有配置）  
并将宿主机maven和jdk映射到对应的容器目录上，同时通过配置--link连接gitlab，因为要从gitlab下代码。

初次启动的时候，可以通过`docker logs -f jenkins`查看控制台的密码，通过这个密码登录系统，执行创建用户等操作

**安装插件**  
启动项目后，下载所需的插件（尤其要下载Git Plugin和Maven Intergration Plugin插件）,如果缺少Maven Integration Plugin插件，在创建job时，不会有`新建一个maven项目选项`

![Image 1][]

jenkins plugin.png

**注意**：在Global Tool Configuration中配置Maven和Jdk,按道理可以配置通过配置JAVA\_HOME 和MAVEN\_HOME，分别指向`/usr/local/jdk`,`/usr/local/maven`，但是通过测试JAVA\_HOME生效了，但MAVEN\_HOME没成效,提示说没有找到maven,所以又通过自动化安装重新配置了maven

![Image 1][]

自动安装maven.png

**配置项目**  
新建一个项目，输入项目名称`demo`,并选择`Maven project`，然后在配置中做如下配置：

![Image 1][]

General Info.png

![Image 1][]

Source Code Management.png

![Image 1][]

Build Triggers.png

每隔5检查是否有新代码发布，如果有则自动执行构建

![Image 1][]

Pre Steps.png

![Image 1][]

Build Settings.png

点开项目，点击左侧菜单`build now`则立马开始一次构建，点开当前构建信息，左侧`Console Output`中，可查看构建的明细

![Image 1][]

Console Output.png

## 集成docker部署 ##

在上述的命令中，基本完成集成，但是还没有使用docker,构建的jar包也无法推送到测试环境或者生产环境，我们可以通过如下思路解决：

> 在项目生成jar包之后，调用项目中Dockerfile文件，使用docker构建镜像，将镜像推送到私有镜像中心的同时，使用该镜像启动一个容器（启动前删除同名容器）

代码如下所示：

# 定义变量
    API_NAME="demo"
    API_VERSION="0.0.1"
    API_PORT=58080
    IMAGE_NAME="127.0.0.1:5000/billjiang/$API_NAME:$BUILD_NUMBER"
    CONTAINER_NAME=$API_NAME-$API_VERSION
    
    # 进入target 目录复制Dockerfile 文件
    cd $WORKSPACE/target
    cp classes/Dockerfile .
    
    #构建docker 镜像
    docker build -t $IMAGE_NAME .
    
    #推送docker镜像
    docker push $IMAGE_NAME
    
    #删除同名docker容器
    cid=$(docker ps | grep "$CONTAINER_NAME" | awk '{print $1}')
    if [ "$cid" != "" ]; then
       docker rm -f $cid
    fi
    
    #启动docker 容器
    docker run -d -p $API_PORT:8080 --name $CONTAINER_NAME $IMAGE_NAME
    
    #删除 Dockerfile 文件
    rm -f Dockerfile

以上未声明的变量$WORKSPACE为jenkins的变量

在`Post Steps`中通过配置以上Execute shell命令，并不能成功执行，发现在`Console Output`中出现docker not found 的错误，是因为jenkins 的容器没有安装docker。所以解决这个问题要么jenkins不使用docker容器安装，要自己安装一个带有docker的jenkins容器，当然还有docker in docker的类似解决方案，本人觉得独立安装jenkins也许算的上一种比较好的方案。

我的个人博客地址为[http://code.admineap.com][http_code.admineap.com] 欢迎访问

参考文献：

[https://www.jianshu.com/p/8b1241a90d7a][https_www.jianshu.com_p_8b1241a90d7a]

[https://www.cnblogs.com/YDDMAX/p/6184100.html][https_www.cnblogs.com_YDDMAX_p_6184100.html]

[https://blog.csdn.net/flyingshuai/article/details/72898665][https_blog.csdn.net_flyingshuai_article_details_72898665]

[http_www.jianshu.com_p_358bfb64e3a6]: https://www.jianshu.com/p/358bfb64e3a6
[Image 1]: 
[http_code.admineap.com]: https://link.jianshu.com?t=http://code.admineap.com
[https_www.jianshu.com_p_8b1241a90d7a]: https://www.jianshu.com/p/8b1241a90d7a
[https_www.cnblogs.com_YDDMAX_p_6184100.html]: https://www.cnblogs.com/YDDMAX/p/6184100.html
[https_blog.csdn.net_flyingshuai_article_details_72898665]: https://blog.csdn.net/flyingshuai/article/details/72898665