前言
前一篇对jenkins的环境搭建做了简单介绍,这一篇内容主要是如何借助jenkins,自动构建并run一个目标docker。基本流程是当gitlab上有新的push产生时,触发jenkins构建任务,jenkins在pull项目并完成如build/make等上线前的准备工作后,将build/make后的文件打包到docker中,并将其run起来。
关键字
Docker、DooD(Docker outside of Docker)、CI、Jenkins
预备知识
- Docker / Dockerfile / Docker Compose
重构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文件放在了前端项目的根目录下。
- 登录Jenkins,新建一个自由风格的软件项目。
- 源码管理选择git,并添加Repository URL、Credentials
-
构建触发器选择Gitlab trigger(如果不存在该选项,则自行到jenkins的插件管理页面安装该插件)
- 构建选择 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:
在设置页面的URL中填写 在构建Jenkins任务选择Gitlab Triggers上方出现的Service URL。点击Add。
添加完成后可以点击Test按钮或者进行git push操作,查看是否可以触发自动构建任务。
至此,持续集成环境的主流程基本完成。流程中后续可以继续添加测试等环节。