Gitlab+Docker部署CI服务器

持续集成(CI,Continuous integration)。持续集成是一种开发实践,通过多次集成和自动化构建来发现错误,使得代码保持高质量。这里介绍针对Ruby on Rails 项目,采用gitlab-ci进行部署的基本过程以及注意事项。

一、gitlab的CI安装与使用

1、安装gitlab-ci-multi-runner

2、启动

$ gitlab-ci-multi-runner start

3、注册runner

$ gitlab-cimulti-runner register

按照提示输入相关的信息(跑runner的机器url、gitlab上的token以及一些其他信息)

4、此时回到gitlab可以查看到注册好的runner

5、配置 .gitlab-ci.yml

二、Docker的基本操作

Docker中有镜像(image)和容器(container)的概念。 可以在这里找到所有基础的镜像,也就是一个系统或服务等;容器是从镜像创建的运行实例,每个容器都是相互隔离的,以此保证安全。

1、运行镜像 如果获得的镜像不能够满足正常使用,可以对docker的image进行“定制”

$ docker run -t -i image:tag /bin/bash $ docker run -t -i ubuntu:14.04 /bin/bash

运行了上述命令后直接进入到ubuntu14.04,与正常使用的系统没有太大区别,可以安装个人需要的服务或是其他,当然很多服务是可以在.gitlab-ci.yml中进行配置好的。

2、镜像‘定制’好了之后需要commit,保存一个最新版本(类似git版本控制)

$ docker commit -m 'description' -a 'something' image_id name:tag

TODO:其他docker的基本操作

三、运行流程

每次push了代码之后,gitlab检测到代码的变化,自动跑runer,根据runner配置文件(.gitlab-ci.yml)进行工作,遇到失败的步骤则终止,详情可以在gitlab中的pipeline中看到。详情见图: ci.png

四、注意事项

在这里列出我遇到的主要问题:

1、关于docker、gitlab和开发者机器(mac)之间的通信:三台机器之间的ssh key要相互确认好关系。 开发机器向gitlab上push代码,docker去gitlab里fetch或者clone代码。 所以,确保gitlab上拥有二者的sshkey。(如果用capistrano,并且是采用docker方式进行deploy,则需要注意capistrano部署的目标服务器是否有docker的sshkey)。

// 拷贝ssh public key $ ssh-copy-id user@host

2、docker进入image:

$ docker run -t -i ubuntu:14.04

如果是要进入到交互式操作,如shell脚本,则-t -i两个参数必须使用,是用来申请一个控制台与寄主机器进行数据交互的,也就是可以在运行docker的机器上看到shell脚本输出结果。

3、.git-ci.yml文件的构成:

(1)该文件会指定任务让CI去执行,images指定了一份镜像,如果自己commit了一份,则命名应该要注意,因为CI会先去docker远程仓库进行查找image,如果没找到才会找本地,所以,当本地命名与远端仓库冲突时,是不会应用本地image的。

(2)services: 该block下可以写一些需要使用到的服务,如:postgres、mysql、others. 这些声明的服务会到docker远程仓库进行查找下载,并集成使用。如果使用的服务都可以找到,则不需要‘定制’image,省去很多事。

(3)如果觉得在该配置文件中写了很多麻烦的任务,可以考虑‘定制’一份image。

(4)自己制作好的image可以提交到docker远程仓库,供大家下载使用。