开始使用GitLab CI/CD

悠悠 2021-12-11 13:43 233阅读 0赞

官方原文档：[https://docs.gitlab.com/ee/ci...][https_docs.gitlab.com_ee_ci...]

> 注：从8.0版本开始，GitLab  [持续集成][Link 1]（CI）完全集成到GitLab中，且默认所有的项目开启。

GitLab提供[持续集成][Link 1]服务。如果添加一个[`.gitlab-ci.yml`文件][.gitlab-ci.yml]到项目根目录，并配置GitLab项目使用某个[Runner][]，然后每一次提交或者是推送都会触发CI [pipeline][].

`.gitlab-ci.yml`文件会告诉GitLab Runner 做什么。默认情况下，它运行一个`pipeline`，分为三个阶段：`build`，`test`，`deploy`。你并不需要用到所有的阶段，没有`job`的阶段会被忽略。

如果一切运行正常(没有非零的返回值)，您将得到与commit关联的漂亮的绿色标记。这使得在查看代码之前，很容易就能看出是否有一个提交导致了测试失败。

大多数项目使用GitLab CI服务来运行测试套件，这样如果开发人员发现问题就会及时得到反馈。

因此，简而言之，CI所需要的步骤可以归结为：

1. 添加`.gitlab-ci.yml`到项目的根目录
            2. 配置一个Runner

从此刻开始，在每一次push到Git仓库的过程中，Runner会自动开启pipline，pipline将显示在项目的Pipline页面中。

--------------------

本指南要求：

*  使用版本8.0+ 的GitLab实例或者是使用[GitLab.com][]
 *  一个想使用GitLab CI的项目

让我们把它分解成碎片，并致力于解决GitLab CI之谜。

# 创建`.gitlab-ci.yml` #

在创建`.gitlab-ci.yml`之前，我们先对它进行个简单的解释。

## `.gitlab-ci.yml`是什么 ##

`.gitlab-ci.yml`是用来配置CI在我们的项目中做些什么工作。它位于项目的根目录。

在任何的push操作，GitLab都会寻找`.gitlab-ci.yml`文件，并对此次commit开始jobs，jobs的内容来源于`.gitlab-ci.yml`文件。

因为`.gitlab-ci.yml`是存在于我们的项目仓库中，并且受版本控制的，所以旧版本也可以执行成功，且使用CI可以让forks更容易，分支可也以拥有不同的pipelines和jobs，而且对于CI来说只会拥有单一的来源。你也可以在我们的博客中找到我们为什么使用`.gitlab-ci.yml`的原因。

## 创建一个简单的`.gitlab-ci.yml` ##

> 注意： `.gitlab-ci.yml`是一个 [YAML][]文件，所以必须要格外注意锁紧。使用空格，而不是tabs。

在项目的根目录创建一个名为`.gitlab-ci.yml`的文件。下面是一个Ruby on Rails项目的示例。

before_script:
      - apt-get update -qq && apt-get install -y -qq sqlite3 libsqlite3-dev nodejs
      - ruby -v
      - which ruby
      - gem install bundler --no-ri --no-rdoc
      - bundle install --jobs $(nproc)  "${FLAGS[@]}"
    
    rspec:
      script:
        - bundle exec rspec
    
    rubocop:
      script:
        - bundle exec rubocop

这是大多数Ruby应用程序最简单的配置：

1.  定义了两个jobs，`rspec`和`rubocop`（名字可以随便取），他们执行不同的命令。
2.  在每个jobs之前，`before_script`定义的命令都将会被执行。

`.gitlab-ci.yml`定义了一系列的jobs，其中包含如何运行和何时运行的限制。jobs必须定义一个名称（在示例中分别是`rspec`和`rubocop`）作为顶级元素，而且总是必须包含`script`关键字。Jobs被用来创建任务，它们会被Runners接受和环境中的Runner执行。

重要的是，每个工作都是独立运行的。

如果你想检验`.gitlab-ci.yml`文件的语法是否正确，在GitLab实例页面中有一个命令行工具`/ci/lint`。也可以从项目中的**CI/CD ➔ Pipelines** and **Pipelines ➔ Jobs**找到此页面。

关于更多`.gitlab-ci.yml`的信息和语法，请阅读[.gitlab-ci.yml][]参考文档。

## 推送`.gitlab-ci.yml`到GitLab ##

一旦创建了`.gitlab-ci.yml`，你应该及时添加到Git仓库并推送到GitLab。

git add .gitlab-ci.yml
    git commit -m "Add .gitlab-ci.yml"
    git push origin master

现在到**Pipelines**页面查看，将会看到该Pipline处于等待状态。

你也可以到**Commits**页面查看，并会发现SHA旁边的暂停按钮。

![1460000012989924_w_764_h_102][]

点击它即可进入到该特定commit的jobs页面。

![1460000012989925_w_1264_h_386][]

## 配置Runner ##

在GitLab中，Runners将会运行你在`.gitlab-ci.yml`中定义的jobs。Runner可以是虚拟机，VPS，裸机，docker容器，甚至一堆容器。GitLab和Runners通过API通信，所以唯一的要求就是运行Runners的机器可以联网。

一个Runner可以服务GitLab中的某个特定的项目或者是多个项目。如果它服务所有的项目，则被称为共享的Runner。

在[Runners][Runner]文档中查阅更多关于不同Runners的信息。

你可以通过**Settings->CI/CD**查找是否有Runners分配到你的项目中。创建一个Runner是简单且直接的。官方支持的Runner是用GO语言写的，它的文档在这里[https://docs.gitlab.com/runner/][https_docs.gitlab.com_runner]。

为了有一个功能性的Runner，你需要遵循以下步骤：

1.  [安装][Link 2]
2.  [配置][Link 3]

按照上面的连接设置你自己的Runner或者使用下一节介绍的共享Runner。

一旦Runner安装好，你可以从项目的**Settings->CI/CD**找到Runner页面。

## ![1460000012989926_w_1275_h_352][] ##

## 共享Runners ##

如果你用的是GitLab.com，你可以使用GitLab公司提供的共享Runners。

这些是运行在GitLab基础设置上面的特殊虚拟机，可以构建任何项目。

你可以通过项目中的**Settings->CI/CD**找到**Shared Runners**，并点击开启它。

[阅读更多关于共享Runners][Runner]。

## 查看pipeline和jobs的状态 ##

成功的配置好Runner后，你应该查看最后一次提交后的状态，从*pending*、到*执行中*、*成功*或*失败*。

你可以通过项目中的Piplines页面查看所有的piplines。

![1460000012989927_w_1261_h_437][]

也可以通过**Piplines->Jobs**页面查看所有的jobs。

![1460000012989928][]

通过点击jobs的状态，查看该job的日志。这对于帮助诊断job失败或者job与预期结果不同很重要。

![1460000012989929_w_1339_h_646][]

你还可以查看在GitLab的各种页面中的任何提交状态，例如**Commits**和**Merge requests**。

## Examples ##

在[这里][Link 4]，可以查看各种语言使用GitLab CI的示例。

[https_docs.gitlab.com_ee_ci...]: https://docs.gitlab.com/ee/ci/quick_start/README.html
[Link 1]: https://about.gitlab.com/gitlab-ci/
[.gitlab-ci.yml]: https://docs.gitlab.com/ee/ci/yaml/README.html
[Runner]: https://docs.gitlab.com/ee/ci/runners/README.html
[pipeline]: https://docs.gitlab.com/ee/ci/pipelines.html
[GitLab.com]: https://gitlab.com/
[YAML]: https://en.wikipedia.org/wiki/YAML
[1460000012989924_w_764_h_102]: /images/20211211/c20a9c0f39be41a9a8a655136b21c7df.png
[1460000012989925_w_1264_h_386]: /images/20211211/7d05fe219bd54f598083f0bf8440734b.png
[https_docs.gitlab.com_runner]: https://docs.gitlab.com/runner/
[Link 2]: https://docs.gitlab.com/runner/install/
[Link 3]: https://docs.gitlab.com/ee/ci/runners/README.html#registering-a-specific-runner
[1460000012989926_w_1275_h_352]: /images/20211211/c6dda983afb047acb39e218165d5568b.png
[1460000012989927_w_1261_h_437]: /images/20211211/39b1be9a87594b309ae9812f27b00d86.png
[1460000012989928]: /images/20211211/2402d9ad0e7d404a9f34193bd923c5a0.png
[1460000012989929_w_1339_h_646]: /images/20211211/7264dafb882447ec8f3620e48acb67c7.png
[Link 4]: https://docs.gitlab.com/ee/ci/examples/README.html