Please enable Javascript to view the contents

GitLab CI 持续集成

 ·  ☕ 3 分钟

1. 基本概念

  • GitLab-CI:GitLab 提供的持续集成系统,管理项目的构建状态,通过 GitLab Runner 来执行构建任务。
  • GitLab-Runner:用于执行构建任务,.gitlab-ci.yml 的 script 部分的运行就是由 GitLab-Runner 来完成。
  • .gitlab-ci.yml:在git项目的根目录下的一个文件,记录了一系列的阶段和执行规则。GitLab-CI 在 git push 后会解析它,根据里面的内容调用 GitLab-Runner 来执行。
  • Pipeline:一次 Pipeline 相当于一次构建任务,里面可以包含多个流程,比如安装依赖、运行测试、编译、部署测试服务器、部署生产服务器等流程。
  • Stages:构建阶段,在一次 Pipeline 中可以定义多个 Stages,所有 Stages 会按照顺序运行,如果任何一个 Stage 失败,那么后面的 Stages 不会执行。
  • Jobs:构建任务,每个 Stage 里面执行的任务。一个 Stage 可以有多个 Job ,全部 Job 会并行执行。

2. 安装 GitLab-Runner

以 Ubuntu 为例:

1
2
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash
apt-get install gitlab-ci-multi-runner

3. 注册 Runner

Runner 需要注册到 GitLab 才可以被项目使用,一个 gitlab-ci-multi-runner 服务可以注册多个 Runner。

1
gitlab-ci-multi-runner register

此时,需要输入一系列 Runner 的相关参数。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
> http://yourdomain.com/ci # 输入 gitlab-ci 的 URL 地址,这里配置为 GitLab 地址 的 `/ci` 路径。
Please enter the gitlab-ci token for this runner:
> XXXXXXXXX # 在【admin area】 页面的 【Overview】- 【Runners】中,可以找到这里需要的 token
Please enter the gitlab-ci description for this runner:
> shell-runner # 这里可以随便输入
Whether to lock Runner to current project [true/false]:
> false
Please enter the executor: docker, parallels, shell, kubernetes, docker-ssh, ssh, virtualbox, docker+machine, docker-ssh+machine:
> shell #如果主要通过命令,执行构建,那么选 shell

查看 Runner 的状态

1
gitlab-ci-multi-runner list 

此时,GitLab 的项目并不能使用新建的 Runner,

在【admin area】 页面的 【Overview】- 【Runners】

点击编辑,将新建的 Runner 授权 【enable】给项目使用。

4. .gitlab-ci.yml

项目的文件结构:

在项目的一级目录下,新建 .gitlab-ci.yml文件,GitLab-CI 指定的文件名。内容如下:

.gitlab-ci.yml

1
2
3
4
5
6
7
8
9
stages:
  - build

job_name:
  stage: build
  script:
    - cd my-app
    - echo "start build"
    - mvn package

主要是两条命令:

  • cd 命令,进入 pom.xml 所在目录
  • mvn 命令,打包项目。

.gitlab-ci.yml 文件保存的是构建过程,采用 YAML 格式,语法规则在文末参考链接中有,构建关键字如下:

关键词 必需 描述
image no 使用docker image
services no 使用docker services
stages no 定义builds阶段
before_script no 定义每个job之前执行的脚本
after_script no 定义每个job之后执行的脚本
variables no 定义build变量
cache no 定义与后续job之间应缓存的文件

5. 执行构建

向 GitLab 提交代码之后,自动执行构建任务。

在项目的 【Pipeline】-【Jobs】选项卡下,可以看到执行情况列表。

在项目的 【Pipeline】-【Jobs】选项卡下,点击【Staus】栏下的颜色按钮【passed】、【failed】、【canceled】按钮,可以看到执行的 Console 输出详情。

在详情的最后,可以看到,最终在 target 目录下生成了一个 my-app-1.0-SNAPSHOT.jar 可执行的 Java 文件。

6. 参考


微信公众号
作者
微信公众号