GitLab-CI环境搭建与操作手册

不信网恋

第一章 系统安装简介
1.1. 系统结构
　　GitLab-CI持续集成服务主要包括gitlab、runner 2个模块。Gitlab主要负责代码文件的管理；runner则负责版本编译、存储、推送等任务。
　　GitLab服务公司原有已经搭建。只需搭建runner服务，并与gitlab对接即可。
第二章 安装环境
2.1. 系统要求：

服务器要求
操作系统	Ubuntu 14（强制要求，sdk代码必须在该系统下编译）
存储	涉及到每日构建版本的存储，建议1T以上
网络	需要连接外网；能够与gitlab服务器通讯
部署服务	Runner、需要支持ant编译、cmake编译
备注

2.2. 系统部署服务介绍
　　Runner：从gitlab服务器上克隆代码到本地进行编译、并出库
　　Ant：wab-app代码编译依赖
　　Cmake：SDK代码编译依赖
第三章 安装Runner
3.1. 安装Docker编译器，使用docker编译需要用到
　　curl -sSL https://get.docker.com/ | sh

3.2. 下载ubuntu Gitlab-Runner安装包
　　curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash

3.3. 安装gitlab-ci-multi-runner
sudo apt-get install gitlab-ci-multi-runner

3.4. 注册并运行runner
　　注册runner并和对应的工程关联起来，我们需要用到工程的token值，所以在这里我们先在gitLab上创建工程

3.4.1创建CI工程
　　1. 进入gitlab web端：http：// http://gitlab.sensenets.com

　　2. 在工程菜单下选择：+new project

　　

　　3. 输入工程名如：CI-test。提交创建

　　4. 在工程页面进入当前工程：CI-test –> setting。在当前页面找到该工程的token

　　

　　

3.4.2注册runner
　　sudo gitlab-ci-multi-runner register

　　

3.4.3检查runner启动状态
　　gitlab-ci-multi-runner list

第四章 调度任务脚本
　　Runner服务起来后，我们在构建编译任务的时候需要告诉runner-ci需要做的事情。这些做的事情就是代码编译的过程。我们打包成脚本，之前注册runner时选择的是shell执行方法

4.1. 创建：.gitlab-ci.yml文件（必须与该文件名一模一样）

4.1.1获取代码编译方法
　　此处以SDK代码为例。基本编译过程为：

　　1. 从gitlab服务器克隆代码到runner服务器

　　git clone http://liyakun:sensenets@gitlab.sensenets.com/yyansheng/sense-crowd.git /home/shench

　　2. 在克隆过来的代码目录下新建一个build目录，并进入该目录

　　3. 执行编译代码

　　cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=./install -DBUILD_EXAMPLES=ON ..

　　make && make install

4.1.2将编译过程打包成脚本写入：.gitlab-ci.yml

第五章 GitLab-CI构建任务下发

5.1. 构建任务下发
　　工程发生更改都会触发ci构建。对.gitlab-ci.yml文件编辑提交信息，即可下发构建任务

5.2. 当前CI构建列表

5.3. 构建结果查询

附录 部分GitLab-Runner常用命令
　　1. gitlab-runner帮助：gitlab-runner –help

　　2. gitlab-runner指定命令帮助：gitlab-runner <commond> –help

　　3. 注册runner：gitlab-runner register

　　4. 注销runner：gitlab-runner unregister

　　5. 当前运行的runner：gitlab-runner list

　　6. 启动runner：gitlab-runner start

　　7. 停止runner：gitlab-runner stop

　　8. 重启runner：gitlab-runner restart

　　9. 查询runner状态：gitlab-runner status

　　其他runner命令可以查询官网介绍：

　　https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/blob/master/docs/commands/README.md

　　centOS系统安装runner:

　　https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/blob/master/docs/install/linux-repository.md