Gitlab CI/CD:入门指南
功能概览
CI/CD工作流
上图是基本的CI/CD工作流,与之对应的,gitlab几乎提供了上述流程节点所需的所有相关功能:
阶段 | 功能 |
---|---|
1. Verify |
|
2. Package |
|
3. Release |
|
4. 其它 |
|
Web端登录Gitlab仓库后,如果有用户有相应权限,可以在左侧边栏看到CI/CD菜单,包含:Pipelines
, Jobs
, Schedules
三个选项。下面对这些菜单的功能和使用方法进行介绍。
- 本文基于GitLab Community Edition 13.4.1进行介绍,在提到相关内容时会提供官网介绍链接方便读者获取一手资料
- GitLab CI/CD官方文档
- 从CircleCI迁移至Gitlab
- 从Jenkins迁移至Gitlab
Pipelines
管线(Pipelines)可以认为是一个集成工作流,可以在仓库代码发生变更时触发一系列操作(脚本或者Jobs)。想要创建管线并执行,需要做两个配置工作:
- 创建
.gitlab-ci.yml
管线配置文件 - 配置GitLab-Runner
配置好之后,可以在Pipelines
菜单中看到已有的管线列表。下面开始具体介绍。
创建第一个管线
想要创建一个管线,只需要在gitlab仓库根目录下创建一个.gitlab-ci.yml
文件,一个简单的示例如下:
default:image: ruby:2.5before_script:- apt-get update- apt-get install -y sqlite3 libsqlite3-dev nodejs- ruby -v- which ruby- gem install bundler --no-document- bundle install --jobs $(nproc) "${FLAGS[@]}"rspec:script:- bundle exec rspecrubocop:script:- bundle exec rubocop
可以手动创建.gitlab-ci.yml
文件,然后编辑内容,也可以借助gitlab提供的模版文件,使用方式是:New File
-> Select a template type
选择.gitlab-ci.yml
即可。
先不管这里面做了什么,当我们配置了上述脚本后,GitLab-CI就自动为我们创建好了管线,但此时管线还是处理pending状态,想要GitLab-CI可以工作起来,我们还需要配置GitLab-Runner。
YAML
文件有两种后缀.yml
和.yaml
,都可以被解析。虽然.gitlab-ci.yml
使用的是.yml
,但是YAML
官方还是推荐使用.yaml
作为YAML
配置文件;- 关于
.gitlab-ci.yml
文件的配置项及其作用,可以参考这两篇:.gitlab-ci.yml
快速上手,.gitlab-ci.yml
完整手册;- 脚本中以返回0表示步骤执行失败,其他非0整数表示步骤执行成功;
- 配置默认需要放在仓库根目录,也支持自定义存放位置;
配置GitLab-Runner
GitLab-Runner是执行管线操作的服务器,可以是物理机、虚拟机、容器(集群)、VPS等任何可以访问该gitlab仓库的服务器,支持配置多个。
管线架构及其配置方法
正如前面提到,管线的目的是及时发现和报告开发集成过程中的问题,因此一个管线执行一般可以分为三个阶段:build
-> test
-> deploy
。
当然如果某个阶段中没有配置Job则会被跳过执行。如果你了解gradle,可以将Job类比gradle的Task,我们知道gradle在配置阶段结束后Task创建完毕并且Task之间建立起有向无环图结构的依赖关系,管线的Jobs也是如此,不过管线Jobs之间还有其他两种关系结构,下面分别了解下。
Basic
如上图,基础结构的特点是:
- 从build到deploy只有一条线路;
- 每个阶段内的Jobs之间并行执行,该阶段内所有Jobs执行完毕执行下个阶段Jobs;
- 每个阶段之间串行执行;
虽然执行效率可能不是很高,但是这个逻辑结构是最简单和易于维护的,因此优先推荐使用这个管线架构。假如要实现上述的集成工作流,我们可以编写如下的配置文件:
stages:- build- test- deployimage: alpinebuild_a:stage: buildscript:- echo "This job builds something."build_b:stage: buildscript:- echo "This job builds something else."test_a:stage: testscript:- echo "This job tests something. It will only run when all jobs in the"- echo "build stage are complete."test_b:stage: testscript:- echo "This job tests something else. It will only run when all jobs in the"- echo "build stage are complete too. It will start at about the same time as test_a."deploy_a:stage: deployscript:- echo "This job deploys something. It will only run when all jobs in the"- echo "test stage complete."deploy_b:stage: deployscript:- echo "This job deploys something else. It will only run when all jobs in the"- echo "test stage complete. It will start at about the same time as deploy_a."
总结一下:
- 每个Job使用
stage
指定执行阶段; - 使用
script
指定执行的脚本内容,脚本行与行之间用-
区分;
Directed Acyclic Graph(DAG)
从上面可以看出,DAG允许从build到test可以有多条线路,可能每条线路的执行时长是不同的,这就很适合那种构建时间比较长,追求执行效率的项目。DAG的特点如下:
- 允许存在多条线路,且线路之间逻辑独立,没有相关等待关系;
- 由于存在多条线路因此会有多个deploy成果物;
想要实现上述结构的管线,配置文件如下:
stages:- build- test- deployimage: alpinebuild_a:stage: buildscript:- echo "This job builds something quickly."build_b:stage: buildscript:- echo "This job builds something else slowly."test_a:stage: testneeds: [build_a]script:- echo "This test job will start as soon as build_a finishes."- echo "It will not wait for build_b, or other jobs in the build stage, to finish."test_b:stage: testneeds: [build_b]script:- echo "This test job will start as soon as build_b finishes."- echo "It will not wait for other jobs in the build stage to finish."deploy_a:stage: deployneeds: [test_a]script:- echo "Since build_a and test_a run quickly, this deploy job can run much earlier."- echo "It does not need to wait for build_b or test_b."deploy_b:stage: deployneeds: [test_b]script:- echo "Since build_b and test_b run slowly, this deploy job will run much later."
总结一下:
- 使用
needs
关键词为每个Job指定所依赖的前置Job;
Child / Parent
针对具有多个deploy成果物且生成过程完全独立的场景,出于配置复用的目的,可以将每中线路单独制作成.gitlab-ci.yml
配置文件,然后用一个总的.gitlab-ci.yml
去集成它们,这就是父子接口的核心思想,其逻辑结构图如下:
同样的,父配置文件如下:
stages:- triggerstrigger_a:stage: triggerstrigger:include: a/.gitlab-ci.ymlrules:- changes:- a/*trigger_b:stage: triggerstrigger:include: b/.gitlab-ci.ymlrules:- changes:- b/*
子配置文件/a/.gitlab-ci.yml
如下:
stages:- build- test- deployimage: alpinebuild_a:stage: buildscript:- echo "This job builds something."test_a:stage: testneeds: [build_a]script:- echo "This job tests something."deploy_a:stage: deployneeds: [test_a]script:- echo "This job deploys something."
子配置文件/b/.gitlab-ci.yml
如下:
stages:- build- test- deployimage: alpinebuild_b:stage: buildscript:- echo "This job builds something else."test_b:stage: testneeds: [build_b]script:- echo "This job tests something else."deploy_b:stage: deployneeds: [test_b]script:- echo "This job deploys something else."
总结如下:
- 使用
stages
申明自定义的阶段; - 使用
trigger
+include
关键词引用子脚本; - 使用
rules
+changes
关键词指定子脚本的影响范围; - 子配置内容自由,不受父配置限制;
- 父配置除了定义引入子配置外,还可以做正常配置文件可以做的事情;
相信看上了面的介绍,你已经基本了解了gitlab管线的流程和配置方法,也能掌握Pipelines
、Jobs
和Schedules
这几个菜单的功能使用了。可以真要上手可能还是一脸懵逼,无从下手,幸好官方已经为我们提供了各种类型项目的.gitlab-ci.yml
模版,我们可以在理解这些模版基础上实现自己的配置文件。
Auto DevOps
官网链接,需要用到的时候参考。
Android工程配置模版
对于安卓项目,gitlab也提供了配置模版[Setting up GitLab CI for Android projects],拷贝如下:
image: openjdk:8-jdkvariables:ANDROID_COMPILE_SDK: "28"ANDROID_BUILD_TOOLS: "28.0.2"ANDROID_SDK_TOOLS: "4333796"before_script:- apt-get --quiet update --yes- apt-get --quiet install --yes wget tar unzip lib32stdc++6 lib32z1- wget --quiet --output-document=android-sdk.zip https://dl.google.com/android/repository/sdk-tools-linux-${ANDROID_SDK_TOOLS}.zip- unzip -d android-sdk-linux android-sdk.zip- echo y | android-sdk-linux/tools/bin/sdkmanager "platforms;android-${ANDROID_COMPILE_SDK}" >/dev/null- echo y | android-sdk-linux/tools/bin/sdkmanager "platform-tools" >/dev/null- echo y | android-sdk-linux/tools/bin/sdkmanager "build-tools;${ANDROID_BUILD_TOOLS}" >/dev/null- export ANDROID_HOME=$PWD/android-sdk-linux- export PATH=$PATH:$PWD/android-sdk-linux/platform-tools/- chmod +x ./gradlew# temporarily disable checking for EPIPE error and use yes to accept all licenses- set +o pipefail- yes | android-sdk-linux/tools/bin/sdkmanager --licenses- set -o pipefailstages:- build- testlintDebug:stage: buildscript:- ./gradlew -Pci --console=plain :app:lintDebug -PbuildDir=lintassembleDebug:stage: buildscript:- ./gradlew assembleDebugartifacts:paths:- app/build/outputs/debugTests:stage: testscript:- ./gradlew -Pci --console=plain :app:testDebug
更多项目示例参考这里GitLab CI/CD Examples
Gitlab CI/CD:入门指南相关推荐
- GitLab CI/CD 视频教程 + 文字教程,从入门到精通。
在去年我写了一篇 Chat 实战:从 0 到 1 GitLab CI/CD 前端持续部署,受到了热烈欢迎,后来又在CSDN直播了GitLab CI/CD 入门及实践,有很多人前来观看,会后也收到了很多 ...
- 基于docker-compose的Gitlab CI/CD实践排坑指南
长话短说 经过长时间实操验证,终于完成基于Gitlab的CI/CD实践,本次实践的坑位很多, 实操过程尽量接近最佳实践(不做hack, 不做骚操作),记录下来加深理解. 看过博客园<docker ...
- git原理详解与实操指南_基于dockercompose的Gitlab CI/CD实践amp;排坑指南
长话短说 经过长时间实操验证,终于完成基于Gitlab的CI/CD实践,本次实践的坑位很多, 实操过程尽量接近最佳实践(不做hack, 不做骚操作),记录下来加深理解. 看过博客园<docker ...
- GitLab CI/CD 新书发布,助企业降本增效
前言 大家好,我是CSDN的拿我格子衫来, 昨天我的第一本书<GitLab CI/CD 从入门到实战>上架啦,这是业内第一本详细讲解GitLab CI/CD的书籍. 历经无数个日夜,最终开 ...
- jenkins 增量发布插件_CI/CD工具:Jenkins还是GitLab CI/CD?
十年来,持续集成(Continuous Integration,CI)和持续交付(Continuous Delivery,CD)领域都取得了很大的进步.DevOps 测试的兴起导致了对 CI/CD 工 ...
- GitLab CI/CD
GitLab CI/CD 是一个内置在GitLab中的工具,用于通过持续方法进行软件开发: Continuous Integration (CI) 持续集成 Continuous Delivery ...
- GitLab CI/CD 因git凭据踩坑
GitLab CI/CD 因git凭据踩坑 [TOC] 1. 问题 我在windows上,使用git push到gitlab中的私有项目上(项目是有ci/cd设置的),runner执行时出现403权限 ...
- 带你深入了解 GitLab CI/CD 原理及流程
作者:狂乱的贵公子 cnblogs.com/cjsblog/p/12256843.html GitLab CI/CD 是一个内置在GitLab中的工具,用于通过持续方法进行软件开发: Continuo ...
- gitlab项目中启用或禁用 GitLab CI/CD Pipeline
默认情况下,GitLab CI/CD 在新安装上会默认启用,要关闭的话,有两种方式: 需要在每个项目下单独关闭. 通过修改源安装和 Omnibus 安装中的设置.(未验证) 1.每个项目单独关闭 要在 ...
最新文章
- vs release 调试 路径设置
- boost::mpl模块实现identity相关的测试程序
- 使用笛卡尔积 cross join解决傻傻的问题
- Software Construction Series(1)
- matlab设计声音听听
- PHP Linux安装
- 最大公约数GCD的三种算法程序
- 一种使用16QAM的OFDM系统MATLAB仿真
- 稞麦显示无法连接服务器,Modern Ops无法连接服务器是什么原因
- 【EDM邮件营销】独立站卖家如何通过用户标签提高EDM邮件打开率
- 《易经》里的28条法则与64个大智慧
- git libpng warning: iCCP: cHRM chunk does not match sRGB
- grabcut图像分割的原理简单介绍
- 顶级计算机语言学大会COLING 2016,亮点迭出一一呈现
- 计算机专业论文可行性研究怎么写,计算机论文怎么写?
- 水深6到9米有鱼吗_你了解过敦煌吗?走进月牙泉
- Java筑基28-泛型
- Flutter提示之Navigator operation requested with a context that does not include a Navigator.
- mt4下载正规的渠道才安全
- 兄弟姐妹们,我终于上岸了,喜获蚂蚁offer,定级p7,万字长文带你走完面试全过程
热门文章
- 塞瓦维斯特定理(不定方程)
- 【Python】python 程序示例
- 用数据说话,Python就业前景分析
- socket:10038错误
- Callback cannot return a non-null value as it gets overwritten by the pipeline
- liblensfun 在 mingw 上编译时遇到的奇怪问题
- 迷宫寻宝(自编简单版)
- [Java并发-14] Future: 优雅的使用多线程
- python汉字转换拼音
- matlab的gccphat转C语言,Python中的GCCPHAT互相关