.gitlab-ci.yml 语法

木木2年前技术文章897

介绍

管道配置从作业(job)开始, 作业是 .gitlab-ci.yml 文件的最基本元素。

job是:

  • 定义了约束,指出应在什么条件下执行

  • 具有任意名称的顶级元素,并且必须至少包含 script 子句

  • 不限制,可以定义多个

示例

job1:
  script: "echo job1"

job2:
  script: "echo job2"

上面是两个简单的job,其中每个 job 都执行不同的命令,在 script 中,可以直接执行命令(/.configure;make;make install)或运行脚本(test.sh)。

验证.gitlab-ci.yml

GitLab CI 的每个实例都有一个称为 Lint 的嵌入式调试工具,该工具可以验证 .gitlab-ci.yml 文件的内容。您可以在 ci/lint 项目名称空间下找到它。

项目 -> CI/CD -> 编辑器

不可用的作业名称

  • image

  • services

  • stages

  • types

  • before_script

  • after_script

  • variables

  • cache

  • include

job配置参数

下表列出 job 了可用的参数

关键字描述
script由 Runner 执行的 Shell 脚本
image使用的 docker 映像。也可用: image:nameimage:entrypoint
services使用的 docker 服务映像。也可用:services:nameservices:aliasservices:entrypoint,和services:command
before_script重写作业之前执行的一组命令。
after_script重写作业后执行的一组命令。
stages定义管道中的阶段。
stage定义作业阶段(默认:test)。
only限制 job 的创建。也可用:only:refs, only:kubernetes, only:variables, and only:changes
except限制什么时候不创建 job。也可用:except:refs, except:kubernetes, except:variables, except:changes
rules用于评估和确定作业的选定属性以及是否创建该作业的条件列表。不可与only/except一起使用。
tags用于选择 Runner 的 tags 列表。
allow_failure允许作业失败。失败的工作不会影响提交状态。
when什么时候开始工作。也可用:when:manualwhen:delayed
environment作业部署到环境的名称。 也可用:environment:nameenvironment:urlenvironment:on_stopenvironment:auto_stop_inenvironment:action
cache在后续运行之间应缓存的文件列表。也可用:cache:pathscache:keycache:untracked,和cache:policy
artifacts成功时附加到作业的文件和目录列表。也可用:artifacts:pathsartifacts:expose_asartifacts:nameartifacts:untrackedartifacts:whenartifacts:expire_inartifacts:reportsartifacts:reports:junit,和artifacts:reports:cobertura。在GitLab 企业版,这些都是可供选择:artifacts:reports:codequalityartifacts:reports:sastartifacts:reports:dependency_scanningartifacts:reports:container_scanningartifacts:reports:dastartifacts:reports:license_managementartifacts:reports:performanceartifacts:reports:metrics
dependencies通过提供要从中获取工件的作业列表,限制将哪些工件传递给特定作业。
coverage给定作业的代码覆盖率设置。
retry发生故障时可以自动重试作业的时间和次数。
timeout定义自定义作业级别的超时,该超时优先于项目范围的设置。
parallel多少个作业实例应并行运行。
trigger定义下游管道触发器。
include允许此作业包括外部YAML文件。也可用:include:localinclude:fileinclude:template,和include:remote
extends该作业将要继承的配置条目。
pages上载作业结果以用于GitLab页面。
variables在作业级别上定义作业变量。
interruptible定义在通过新的运行使其冗余时是否可以取消作业。
resource_group限制作业并发。

构建

为了组织我们的构建、测试和部署配置,我们需要知道如何将作业放入各个阶段。

  • 查看默认的构建阶段

  • 声明自定义构建阶段和顺序

  • 指定使用特定的 Runner

默认的构建阶段

默认的构建阶段有三个阶段:

  • build

  • test

  • deploy

阶段的执行顺序按照上面的排序执行。所有未指定的阶段默认为 test 阶段

job1:
  stage: test
  script: echo "test"

job2:
  stage: build
  script: echo "build"

job3:
  stage: deploy
  script: echo "deploy"

job4:
  script: echo "job4"

声明自定义阶段和顺序

  • 每个阶段(stage)包含一个或多个 Jobs

  • 阶段按其声明的顺序运行

  • 任何作业失败都将阶段标记为失败

stages:
  - build
  - test
  - review
  - deploy

job1:
  stage: test
  script: echo "test"

job2:
  stage: build
  script: echo "build"

job3:
  stage: deploy
  script: echo "deploy"

job4:
  script: echo "job4"

job5:
  stage: review
  script: echo "review"

使用特定的runner

如果Runner 有多个可用,会使用轮询的方式。如果需要使用指定的 Runner 运行,可以使用 tag 标签。

stages:
  - build
  - test
  - review
  - deploy

job1:
  stage: test
  script: echo "test"
  tags:
    - aishangwei-group
    - docker

job2:
  stage: build
  script: echo "build"
...


相关文章

MySQL运维实战(5.5) 数据导入导出时的字符集问题

mysql可以使用load data/select into outfile或mysqldump工具进行数据导入导出。下面分别分析数据导入导出时的字符集相关问题。准备测试数据创建测试表,2个字段分别使...

EMR-flinksql运行失败问题

EMR-flinksql运行失败问题

运行flinksqlsql-client.sh报错:[root@emr1 bin]# ./sql-client.shSLF4J: Class path contains multiple SLF4J...

NetworkManager和常用工具和基本用法

NetworkManager和常用工具和基本用法

现代人的生活越来越依赖网络,对于一个操作系统来讲,网络功能的支持和管理就更为重要了,本节课我们一起来看一下在CentOS8中如何对网络进行管理NetworkManager和常用工具和基本用法Netwo...

高效便捷!解锁阿里云跨账号专线互联的全新实施方案

高效便捷!解锁阿里云跨账号专线互联的全新实施方案

01背    景为持续提升金融云环境的合规标准以及可用区内产品服务的性能和稳定性,阿里云将对杭州地域BCD三个金融云可用区进行基础设施架构升级与改造,对应可用区云产品将于 2024...

WAF 透明接入模式

WAF 透明接入模式

透明接入模式只需将需要防护的网站信息添加到WAF,无需修改域名的DNS解析设置,即可实现WAF防护。如果您的源站服务器为ECS服务器或者部署在阿里云公网SLB上,那么除了使用CNAME接入模式,还可以...

Prometheus PromQL语法

一、PromQL语法1.1、数据类型PromQL 表达式计算出来的值有以下几种类型:瞬时向量 (Instant vector)区间向量 (Range vector)标量数据 (Scalar)字符串 (...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。