Gitlab CI/CD 流水线配置参考

Gitlab CI/CD 流水线配置参考

.gitlab-ci.yml文件定义了流水线的结构和顺序，并确定：

• 使用GitLab Runner执行什么。
• 遇到特定条件时要做出哪些决定。例如，当进程成功或失败时。

不可用的jobs名称

每个作业必须具有唯一的名称，但有一些保留的关键字不能用作作业名称：

• image
• services
• stages
• types
• before_script
• after_script
• variables
• cache

配置参数

参数	作用描述
script	script是job所需要的唯一必须的参数。它是一个由Runner执行的shell脚本
image	用于指定用于job的Docker镜像。
services	用于指定服务的Docker镜像，链接到镜像中指定的基本镜像。
before_script	用于定义应在所有作业（包括部署作业）之前运行但在恢复工件之后运行的命令。这可以是数组或多行字符串。
after_script	用于定义将在所有作业（包括失败的作业）之后运行的命令。这必须是数组或多行字符串。
stages	用于定义可由作业使用的阶段，并在全范围内定义。
stage	stage是按工作定义的，依赖于全局定义的阶段。它允许将作业分组到不同的阶段，并且同一阶段的作业并行执行（受特定条件限制）。
only	定义作业将运行的分支（branches）和标记（tags）的名称。
except	定义作业不会运行的分支和标记的名称。
tags	用于从允许运行此项目的所有运行程序列表中选择特定的运行程序。
allow_failure	允许作业失败而不会影响CI套件的其余部分。除手动作业外，默认值为false。
when	用于实现在发生故障或尽管发生故障时运行的作业。取值：on_success，on_failure，always ，manual
environment	用于定义作业部署到特定环境。如果指定了环境且该名称下没有环境，则将自动创建一个新环境。
cache	用于指定应在作业之间缓存的文件和目录列表。您只能使用项目工作区内的路径。
artifacts	用于指定文件和目录的列表，这些文件和目录应在成功，失败或始终作业时附加到作业。作业完成后，工件将被发送到GitLab，并可在GitLab UI中下载。
dependencies	此功能应与工件结合使用，并允许您定义要在不同作业之间传递的工件。
coverage	允许您配置从作业输出中提取代码覆盖率的方式。
retry	允许您配置在发生故障时重试作业的次数。
parallel	允许您配置并行运行的作业实例数。该值必须大于或等于二（2）且小于或等于50。
trigger	允许您定义下游流水线触发器。当GitLab启动从触发器定义创建的作业时，将创建下游流水线
include	使用include关键字，您可以允许包含外部YAML文件。 include要求外部YAML文件具有扩展名.yml或.yaml，否则将不包括外部文件。
extends	定义了使用extends的作业将继承的作业名称。
pages	是一项特殊工作，用于将静态内容上传到GitLab，可用于为您的网站提供服务。它具有特殊语法，因此必须满足以下两个要求：任何静态内容都必须放在public/目录下。必须定义具有public/目录路径的工件。
variables	GitLab CI/CD允许您在.gitlab-ci.yml中定义变量，然后在作业环境中传递。 它们可以在全局和每个作业设置。 在作业级别使用variables关键字时，它会覆盖全局YAML变量和预定义变量。

转载于:https://my.oschina.net/jast90/blog/3079130