GitLab 是一款完全集成的软件开发平台(fully integrated software development platform)。[1] [2] GitLab是一个基于Git的平台。

GitLab CI/CD 是 GitLab 内置的一款工具,用于 通过 持续方法论(continuous methodologies)的软件开发。 该持续方法论包含三个部分:持续集成持续交付持续部署[3][4]

  • 持续集成(Continuous Integration,简称CI),每次在上传代码块到基于Git仓库时,持续集成 会运行脚本去构建、测试、校验代码,这些操作是在合并到默认分支之前进行的。
  • 持续交付(Continuous Delivery,简称CD),在 持续集成 之后(即合并到默认分支之后),持续交付 将进行手动部署应用。
  • 持续部署(Continuous Deployment,简称CD),在 持续集成 之后(即合并到默认分支之后),持续部署 将进行自动部署应用。

原理

编辑

当开发者配置了 GitLab CI/CD,那么当开发者使用 git 提交(commit),那么就会触发 CI/CD 相关的一系列操作。 这一系列操作由 GitLab Runne 执行,相关配置记载于.gitlab-ci.yml文件中,执行的结果将在Gitlab页面中展示。[5] 每一次的提交(commit)将会出发一条流水线(pipeline),流水线是不同阶段(Stage)任务(Job)的一个集合。[5] 阶段(Stage)用于逻辑切割,同一阶段的任务以并行方式执行,阶段间是顺序执行,上一个阶段执行失败,下一个阶段将不会执行。[6] .pre 为第一阶段(译为:之前) 和 .post 最后阶段(译为:提交时),这两个阶段不需要被定义,也无法被修改。[7]

示例如下:

stages:
  - build
  - test
  - deploy

job 0:
  stage: .pre
  script: make something useful before build stage

job 1:
  stage: build
  script: make build dependencies

job 2:
  stage: build
  script: make build artifacts

job 3:
  stage: test
  script: make test

job 4:
  stage: deploy
  script: make deploy

job 5:
  stage: .post
  script: make something useful at the end of pipeline

任务(Job)可以构建Artifacts ,提供用户下载。[5] 利用场景如下:在Android项目中,当配置了自动化构建Artifacts后,每次提交(push)代码后,GitLab CI/CD 将自动构建 APK文件,并在GitLab的页面上提供下载按钮。

任务(Job)可以自动部署文件到外部服务器,并通过 GitLab 页面查看该服务器现今部署的状态,以及进行重新部署(re-deploy)等操作。通过使用设定 environmentnameurl ,还可以在GitLab页面直接上查看网站。[8][9] 通过该操作可以达到 持续部署 的目的。[9]

deploy_staging:
  stage: deploy
  script:
    - echo "Deploy to staging server"
  environment:
    name: staging
    url: http://172.23.0.2:5000/
  only:
  - master
  tags:
    - Runner名称

GitLab Runner

编辑

GitLab Runner 是一项开源项目,用于执行任务(Job),并将执行结果传输回Gitlab。[10]

Runner 可安装在操作系统,也可以通过Docker的方式安装。当 Runner 安装后,需要将其注册在 GitLab 中,方可使用。Runner 有若干种执executor可供使用,如:DockerShellSSH[10] Runner 默认使用Shell,Shell模式下,所有构建都会发生在Runner安装的机器中,操作十分简单,但是缺点很多。[11][12]

.gitlab-ci.ym 文件中通过 tags 关键词选择Runner。[13]Runner 的相关配置在 config.toml 文件中记载。[14]

与Docker结合

编辑

对 基于Docker的项目 进行构建和测试,有几种方式。[15]一种方式是,使用shell executor进行Docker CLI命令操作。[16] 另一种方式就是使用Docker executor进行操作,它是官方推荐的操作,executor通过在Docker中使用 Docker-in-Docker镜像 进行Job相关操作。[17]

Mattermost

编辑

Mattermost

参考文献

编辑
  1. ^ GitLab Pricing. GitLab. [2020-03-23] (英语). 
  2. ^ User Docs | GitLab 中文文档教程. s0docs0gitlab0com.icopy.site. [2020-03-23]. 
  3. ^ GitLab CI/CD | GitLab. docs.gitlab.com. [2020-03-25]. 
  4. ^ Introduction to CI/CD with GitLab | GitLab. docs.gitlab.com. [2020-03-27]. 
  5. ^ 5.0 5.1 5.2 A beginner's guide to continuous integration. GitLab. [2020-03-27] (英语). 
  6. ^ stages. docs.gitlab.com. [2020-03-27]. 
  7. ^ pre-and-post. docs.gitlab.com. [2020-03-27]. 
  8. ^ A beginner's guide to continuous integration. GitLab. [2020-03-27] (英语). 
  9. ^ 9.0 9.1 Environments and deployments | GitLab. docs.gitlab.com. [2020-03-27]. 
  10. ^ 10.0 10.1 GitLab Runner Docs | GitLab. docs.gitlab.com. [2020-03-22]. 
  11. ^ Executors | GitLab. docs.gitlab.com. [2020-03-24]. 
  12. ^ Shell | GitLab. docs.gitlab.com. [2020-03-24]. 
  13. ^ GitLab CI/CD Pipeline Configuration Reference | GitLab. docs.gitlab.com. [2020-03-26]. 
  14. ^ Advanced configuration | GitLab. docs.gitlab.com. [2020-03-26]. 
  15. ^ Building Docker images with GitLab CI/CD | GitLab. docs.gitlab.com. [2020-03-26]. 
  16. ^ Building Docker images with GitLab CI/CD | GitLab. docs.gitlab.com. [2020-03-26]. 
  17. ^ Building Docker images with GitLab CI/CD | GitLab. docs.gitlab.com. [2020-03-26].