基于Docker版jenkins的持续集成环境搭建(二)

2019年6月11日 287次阅读 来源: WilliamWei

前言

前一篇对jenkins的环境搭建做了简单介绍，这一篇内容主要是如何借助jenkins，自动构建并run一个目标docker。基本流程是当gitlab上有新的push产生时，触发jenkins构建任务，jenkins在pull项目并完成如build／make等上线前的准备工作后，将build／make后的文件打包到docker中，并将其run起来。

关键字

Docker、DooD(Docker outside of Docker)、CI、Jenkins

预备知识

重构Jenkins镜像

新建Dockerfile，以官方Jenkins为基本镜像(不建议使用alpine的版本，虽然镜像文件比较小，但是后面的过程中遇到了很多问题，最好还是果断弃坑回到ubuntu)，将jenkins用户加入到docker的group中，原因后面会说，并安装nodejs（这个可选）。

FROM jenkins

USER root
ARG dockerGid=978


ENV NODE_VERSION 6.9.4

#add jenkins to docker group and install nodejs/npm

RUN echo "docker:x:${dockerGid}:jenkins" >> /etc/group \
    && cd /home \
    && curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.xz" \
    && xz -d "node-v$NODE_VERSION-linux-x64.tar.xz" \
    && tar xvf "node-v$NODE_VERSION-linux-x64.tar" \
    && ln -s /home/node-v$NODE_VERSION-linux-x64/bin/node /usr/local/bin/node \
    && ln -s /home/node-v$NODE_VERSION-linux-x64/bin/npm /usr/local/bin/npm \
    && rm -rf "node-v$NODE_VERSION-linux-x64.tar"


USER jenkins

这里的dockerGid参数为host上docker用户组的groupid，运行命令：

docker build -t local_jenkins .

构建自己的本地jenkins镜像

启动容器

这里选择使用docker compose工具，将各项参数写到文件中。

** * 这里相比上一篇多了两个挂载点，一个是/bin/docker，一个是/var/run/docker.sock。实现DooD（Docker outside of Docker)的关键就在这里，通过将docker、docker.scok暴露到jenkins的容器中，由于jenkins用户已在docker的组中，故有权限使用docker命令，且run起来的container实际上就是是运行在host主机上。* **

  • docker-compose.yml文件：
version: '2'
services:
  my_jenkins:
    image: local_jenkins
    volumes:
      - /root/docker/jenkins:/var/jenkins_home
      - /bin/docker:/usr/bin/docker
      - /var/run/docker.sock:/var/run/docker.sock

    ports:
      - "9000:8080"

运行命令：

docker-compose up

我们定制好的jenkins container就可以正常工作了。

构建任务

首先是一些准备工作。目标任务是一个AngularJS的前端项目(可以参看我的另一篇文章webpack-angular，基本类似)，需要nodejs／npm准备环境，由于全部为静态文件，所以选用nginx作为服务器。

目标Container的Dockerfile：将webpack构建后的文件（位于build目录）拷贝到容器的html目录内。不推荐使用挂载点的方式进行，尽量减少容器的依赖。

FROM nginx:stable-alpine

COPY ./build/* /usr/share/nginx/html/

我这里是直接把Dockerfile文件放在了前端项目的根目录下。

  1. 登录Jenkins，新建一个自由风格的软件项目。
  2. 源码管理选择git，并添加Repository URL、Credentials

  3. 构建触发器选择Gitlab trigger(如果不存在该选项，则自行到jenkins的插件管理页面安装该插件)

    《基于Docker版jenkins的持续集成环境搭建(二)》

  4. 构建选择 Execute Shell，命令如下：
npm update;
npm start test;
docker stop front_dev || true;
docker rm front_dev || true;
docker build -t front_dev .;
docker run --name front_dev -p 10080:80 -d front_dev;

这里有几个注意点：

  • ** docker stop／rm 命令后加上 || true**
    当shell中有命令执行失败时，jenkins会判定构建失败，从而结束构建工作。加上||true，无论当前front_dev 是否在运行，是否有，该命令都返回执行成功，使shell可以继续执行下去

  • **docker run -d **
    -d 表示容器以daemon状态运行，有些镜像run之后会处于挂起状态，使得构建的shell脚本一直无法结束

  • shell中的front_dev为镜像、容器名字，可以自行重命名

Gitlab Trigger

登录gitlab，进入项目页面。右上角选择Webhooks：

《基于Docker版jenkins的持续集成环境搭建(二)》

在设置页面的URL中填写
在构建Jenkins任务选择Gitlab Triggers上方出现的Service URL。点击Add。

添加完成后可以点击Test按钮或者进行git push操作，查看是否可以触发自动构建任务。

至此，持续集成环境的主流程基本完成。流程中后续可以继续添加测试等环节。

参考

    原文作者：WilliamWei
    原文地址: https://www.jianshu.com/p/33896fdaad77
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞