Gitlab流水线配置

embedded/2025/1/15 21:26:20/

由于格式和图片解析问题,为了更好阅读体验可前往 阅读原文

流水线的流程是,提交代码后,gitlab会检测项目根目录里的.github-ci.yml文件,根据文件中的流水线自动构建,配置文件格式正确性可以在gitlab进行文件校验,格式使用yaml文件格式,一个yaml文件就是一个流水线,里面会定义多个作业

示例

stages:- install- build- deployinstall_job:stage: installtags:- dockerscript:- echo install stagebuild_job:stage: buildscript:- echo build stagedeploy_job:stage: deployscript:- echo deploy stage

默认变量

gitlab会提供一些默认变量使用,这里列出默认变量

https://docs.gitlab.com/ee/ci/variables/predefined_variables.html

通用变量

变量GitLabRunner描述
CHAT_CHANNEL10.6all触发 ChatOps 命令的源聊天频道。
CHAT_INPUT10.6all使用 ChatOps 命令传递的附加参数。
CHAT_USER_ID14.4all触发 ChatOps 命令的用户的聊天服务用户 ID。
CIall0.4适用于在 CI/CD 中执行的所有作业。可用时为 true
CI_API_V4_URL11.7allGitLab API v4 根 URL。
CI_BUILDS_DIRall11.10执行构建的顶级目录。
CI_COMMIT_AUTHOR13.11allName <email> 格式的提交作者。
CI_COMMIT_BEFORE_SHA11.2all出现在分支或标签上的上一个最新提交。在合并请求的流水线中总是 0000000000000000000000000000000000000000
CI_COMMIT_BRANCH12.60.5提交分支名称。在分支流水线中可用,包括默认分支的流水线。在合并请求流水线或标签流水线中不可用。
CI_COMMIT_DESCRIPTION10.8all提交的描述。如果标题短于 100 个字符,则消息没有第一行。
CI_COMMIT_MESSAGE10.8all完整的提交消息。
CI_COMMIT_REF_NAME9.0all为其构建项目的分支或标签名称。
CI_COMMIT_REF_PROTECTED11.11all如果作业正在运行以获取受保护的 ref 为 true
CI_COMMIT_REF_SLUG9.0allCI_COMMIT_REF_NAME 小写,缩短为 63 字节,除了 0-9a-z 之外的所有内容都替换为 -。没有前导/尾随-。 在 URL、主机名和域名中使用。
CI_COMMIT_SHA9.0all项目为其构建的提交修订。
CI_COMMIT_SHORT_SHA11.7allCI_COMMIT_SHA 的前八个字符。
CI_COMMIT_TAG9.00.5提交标签名称。仅在标签流水线中可用。
CI_COMMIT_TAG_MESSAGE15.5all提交标签消息。仅在标签流水线中可用。
CI_COMMIT_TIMESTAMP13.4allISO 8601 格式的提交时间戳。
CI_COMMIT_TITLE10.8all提交的标题。消息的完整第一行。
CI_CONCURRENT_IDall11.10单个 executor 中构建执行的唯一 ID。
CI_CONCURRENT_PROJECT_IDall11.10单个 executor 和项目中构建执行的唯一 ID。
CI_CONFIG_PATH9.40.5CI/CD 配置文件的路径。默认为.gitlab-ci.yml。在正在运行的流水线中只读。
CI_DEBUG_TRACEall1.7如果 debug 日志 (跟踪) 已启用为true
CI_DEBUG_SERVICES15.715.7true 如果启用了服务容器日志,值为 true
CI_DEFAULT_BRANCH12.4all项目默认分支的名称。
CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX13.7all通过 Dependency Proxy 拉取镜像的顶级群组镜像前缀。
CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX14.3all通过 Dependency Proxy 拉取镜像的直接群组镜像前缀。
CI_DEPENDENCY_PROXY_PASSWORD13.7all通过 Dependency Proxy 拉取镜像的密码。
CI_DEPENDENCY_PROXY_SERVER13.7all用于登录 Dependency Proxy 的服务器。相当于 $CI_SERVER_HOST:$CI_SERVER_PORT
CI_DEPENDENCY_PROXY_USER13.7all通过 Dependency Proxy 拉取镜像的用户名。
CI_DEPLOY_FREEZE13.2all仅当流水线在部署冻结窗口期间运行时才可用。可用时为 true
CI_DEPLOY_PASSWORD10.8allGitLab Deploy Token 的认证密码,如果项目有的话。
CI_DEPLOY_USER10.8allGitLab Deploy Token 的认证用户名,如果项目有的话。
CI_DISPOSABLE_ENVIRONMENTall10.1仅当作业在一次性环境中执行时才可用(仅为该作业创建并在执行后处理/销毁 - 除 shellssh 之外的所有 executor)。可用时为 true
CI_ENVIRONMENT_NAME8.15all此作业的环境名称。 如果设置了 environment:name,则可用。
CI_ENVIRONMENT_SLUG8.15all环境名称的简化版本,适合包含在 DNS、URL、Kubernetes labels 等。如果设置了 environment:name,则可用。Slug 被截断为 24 个字符。
CI_ENVIRONMENT_URL9.3all此作业的环境 URL。如果设置了 environment:url,则可用。
CI_ENVIRONMENT_ACTION13.11all为此作业的环境指定的操作注释。如果设置了 environment:action,则可用。可以是startpreparestop
CI_ENVIRONMENT_TIER14.0all此作业的环境部署级别。
CI_RELEASE_DESCRIPTION15.5all发布的描述。仅在标签流水线上可用。描述长度限制为前 1024 个字符。
CI_GITLAB_FIPS_MODE14.10all实例中是否启用 FIPS 模式的配置设置。
CI_HAS_OPEN_REQUIREMENTS13.1all仅当流水线的项目具有打开的需求 时才可用。可用时为 true
CI_JOB_ID9.0all作业的内部 ID,在 GitLab 实例中的所有作业中是唯一的。
CI_JOB_IMAGE12.912.9运行作业的 Docker 镜像的名称。
CI_JOB_JWT12.10all一个 RS256 JSON Web 令牌,用于与支持 JWT 身份验证的第三方系统进行身份验证,例如 HashiCorp’s Vault。
CI_JOB_JWT_V114.6allCI_JOB_JWT 相同的值。
CI_JOB_MANUAL8.12all如果作业是手动启动为 true
CI_JOB_NAME9.00.5作业名称
CI_JOB_NAME_SLUG15.4allCI_JOB_NAME_SLUG 的小写,缩短为 63 字节,除 0-9a-z 以外的所有内容都替换为 -。没有前导/尾随的 -。在路径中使用。
CI_JOB_STAGE9.00.5作业阶段名称
CI_JOB_STATUSall13.5执行每个 runner 阶段时的作业状态。与 after_script 一起使用。可以是 successfailedcanceled
CI_JOB_TOKEN9.01.2使用某些 API 端点进行身份验证的令牌。只要作业正在运行,令牌就有效。
CI_JOB_URL11.10.5作业详细信息 URL。
CI_JOB_STARTED_AT13.10all作业开始时的 UTC 日期时间,采用 ISO 8601 格式。
CI_KUBERNETES_ACTIVE13.0all仅当流水线具有可用于部署的 Kubernetes 集群时才可用。可用时为 true
CI_NODE_INDEX11.5all作业集中的作业 index。仅当作业使用 parallel 时可用。
CI_NODE_TOTAL11.5all此作业并行运行的实例总数。如果作业不使用 parallel,则设置为 1
CI_OPEN_MERGE_REQUESTS13.8all使用当前分支和项目作为合并请求源的最多四个合并请求的逗号分隔列表。如果分支具有关联的合并请求,则仅在分支和合并请求流水线中可用。例如,gitlab-org/gitlab!333,gitlab-org/gitlab-foss!11
CI_PAGES_DOMAIN11.8all托管 GitLab Pages 的配置域名。
CI_PAGES_URL11.8allGitLab Pages 站点的 URL。始终是 CI_PAGES_DOMAIN 的子域名。
CI_PIPELINE_ID8.10all当前流水线的实例级 ID。该 ID 在实例上的所有项目中都是唯一的。
CI_PIPELINE_IID11.0all当前流水线的项目级 IID(内部 ID)。此 ID 仅在当前项目中是唯一的。
CI_PIPELINE_SOURCE10.0all流水线是如何触发的。可以是 pushwebscheduleapiexternalchatwebidemerge_request_eventexternal_pull_request_eventparent_pipelinetriggerpipeline
CI_PIPELINE_TRIGGEREDallall如果作业是触发的为 true。
CI_PIPELINE_URL11.10.5流水线详细信息的 URL。
CI_PIPELINE_CREATED_AT13.10all创建流水线时的 UTC 日期时间,采用 ISO 8601 格式。
CI_PROJECT_DIRallall仓库克隆到的完整路径,以及作业从哪里运行。如果设置了 GitLab Runner builds_dir 参数,这个变量是相对于 builds_dir 的值设置的。
CI_PROJECT_IDallall当前项目的 ID。该 ID 在实例上的所有项目中都是唯一的。
CI_PROJECT_NAME8.100.5项目目录的名称。例如,如果项目 URL 是 gitlab.example.com/group-name/project-1,则 CI_PROJECT_NAMEproject-1
CI_PROJECT_NAMESPACE8.100.5作业的项目命名空间(用户名或组名)。
CI_PROJECT_PATH_SLUG9.3all$CI_PROJECT_PATH 小写,不是 a-z0-9 的字符替换为 - 并缩短为 63 字节。 在 URL 和域名中使用。
CI_PROJECT_PATH8.100.5包含项目名称的项目命名空间。
CI_PROJECT_REPOSITORY_LANGUAGES12.3all仓库中使用的语言的逗号分隔的小写列表。例如ruby,javascript,html,css
CI_PROJECT_ROOT_NAMESPACE13.20.5作业的根项目命名空间(用户名或组名)。例如,如果CI_PROJECT_NAMESPACEroot-group/child-group/grandchild-group,则 CI_PROJECT_ROOT_NAMESPACEroot-group
CI_PROJECT_TITLE12.4allWeb 界面中显示的人类可读的项目名称。
CI_PROJECT_DESCRIPTION15.1allWeb 界面中显示的项目描述。
CI_PROJECT_URL8.100.5项目的 HTTP(S) 地址。
CI_PROJECT_VISIBILITY10.3all项目可见性。可以是 internalprivatepublic
CI_PROJECT_CLASSIFICATION_LABEL14.2all项目外部授权分类标记。
CI_REGISTRY_IMAGE8.100.5项目的 Container Registry 的地址。仅当为项目启用了 Container Registry 时才可用。
CI_REGISTRY_PASSWORD9.0all将容器推送到项目的 GitLab Container Registry 的密码。仅当为项目启用了 Container Registry 时才可用。 此密码值与 CI_JOB_TOKEN 相同,并且仅在作业运行时有效。使用 CI_DEPLOY_PASSWORD 长期访问镜像库。
CI_REGISTRY_USER9.0all将容器推送到项目的 GitLab Container Registry 的用户名。仅当为项目启用了 Container Registry 时才可用。
CI_REGISTRY8.100.5GitLab Container Registry 的地址。仅当为项目启用了 Container Registry 时才可用。 如果在镜像库配置中指定了一个值,则此变量包括一个 :port 值。
CI_REPOSITORY_URL9.0all克隆 Git 仓库的 URL。
CI_RUNNER_DESCRIPTION8.100.5runner 的描述。
CI_RUNNER_EXECUTABLE_ARCHall10.6GitLab Runner 可执行文件的操作系统/架构。可能和 executor 的环境不一样。
CI_RUNNER_ID8.100.5正在使用的 runner 的唯一 ID。
CI_RUNNER_REVISIONall10.6运行作业的 runner 的修订版。
CI_RUNNER_SHORT_TOKENall12.3runner 的唯一 ID,用于验证新的作业请求。在 14.9 及更高版本中,令牌包含前缀,并且使用前 17 个字符。在 14.9 版本之前,使用前八个字符。
CI_RUNNER_TAGS8.100.5以逗号分隔的 runner 标签列表。
CI_RUNNER_VERSIONall10.6运行作业的 GitLab Runner 的版本。
CI_SERVER_HOST12.1allGitLab 实例 URL 的主机,没有协议或端口。例如gitlab.example.com
CI_SERVER_NAMEallall协调作业的 CI/CD 服务器的名称。
CI_SERVER_PORT12.8allGitLab 实例 URL 的端口,没有主机或协议。例如 8080
CI_SERVER_PROTOCOL12.8allGitLab 实例 URL 的协议,没有主机或端口。例如 https
CI_SERVER_REVISIONallall计划作业的 GitLab 修订版。
CI_SERVER_TLS_CA_FILEallall包含 TLS CA 证书的文件,用于在 runner 设置中设置 tls-ca-file 时验证极狐GitLab 服务器。
CI_SERVER_TLS_CERT_FILEallall包含 TLS 证书的文件,用于在 runner 设置中设置 tls-ca-file 时验证极狐GitLab 服务器。
CI_SERVER_TLS_KEY_FILEallall包含 TLS 密钥的文件,用于在 runner 设置中设置 tls-ca-file 时验证极狐GitLab 服务器。
CI_SERVER_URL12.7allGitLab 实例的基本 URL,包括协议和端口。 例如https://gitlab.example.com:8080
CI_SERVER_VERSION_MAJOR11.4allGitLab 实例的主版本。例如,如果版本为 13.6.1,则CI_SERVER_VERSION_MAJOR13
CI_SERVER_VERSION_MINOR11.4allGitLab 实例的小版本。例如,如果版本为 13.6.1,则CI_SERVER_VERSION_MINOR6
CI_SERVER_VERSION_PATCH11.4allGitLab 实例的补丁版本。例如,如果版本为 13.6.1,则CI_SERVER_VERSION_PATCH1
CI_SERVER_VERSIONallallGitLab 实例的完整版本。
CI_SERVERallall适用于在 CI/CD 中执行的所有作业。可用时为 true
CI_SHARED_ENVIRONMENTall10.1仅当作业在共享环境中执行时才可用(跨 CI/CD 调用持久化的,如 shellssh executor)。可用时为 true
GITLAB_CIallall适用于在 CI/CD 中执行的所有作业。可用时为 true
GITLAB_FEATURES10.6all可用于实例和许可证的许可功能的逗号分隔列表。
GITLAB_USER_EMAIL8.12all开始作业的用户的电子邮件。
GITLAB_USER_ID8.12all启动作业的用户的 ID。
GITLAB_USER_LOGIN10.0all开始作业的用户的用户名。
GITLAB_USER_NAME10.0all启动作业的用户的姓名。
TRIGGER_PAYLOAD13.9allwebhook 负载。仅当流水线使用 webhook 触发时可用。

合并请求变量

变量GitLabRunner描述
CI_MERGE_REQUEST_APPROVED14.1all合并请求的批准状态。当合并请求批准 可用并且合并请求已被批准时为 true
CI_MERGE_REQUEST_ASSIGNEES11.9all合并请求的指派人用户名的逗号分隔列表。
CI_MERGE_REQUEST_ID11.6all合并请求的实例级 ID。这是 GitLab 上所有项目的唯一 ID。
CI_MERGE_REQUEST_IID11.6all合并请求的项目级 IID(内部 ID)。此 ID 对于当前项目是唯一的。
CI_MERGE_REQUEST_LABELS11.9all合并请求的逗号分隔标签名称。
CI_MERGE_REQUEST_MILESTONE11.9all合并请求的里程碑标题。
CI_MERGE_REQUEST_PROJECT_ID11.6all合并请求的项目 ID。
CI_MERGE_REQUEST_PROJECT_PATH11.6all合并请求的项目路径。例如 namespace/awesome-project
CI_MERGE_REQUEST_PROJECT_URL11.6all合并请求的项目的 URL。例如,http://192.168.10.15:3000/namespace/awesome-project
CI_MERGE_REQUEST_REF_PATH11.6all合并请求的引用路径。例如,refs/merge-requests/1/head
CI_MERGE_REQUEST_SOURCE_BRANCH_NAME11.6all合并请求的源分支名称。
CI_MERGE_REQUEST_SOURCE_BRANCH_SHA11.9all合并请求的源分支的 HEAD SHA。该变量在合并请求流水线中为空。SHA 仅存在于合并结果流水线中。
CI_MERGE_REQUEST_SOURCE_PROJECT_ID11.6all合并请求的源项目的 ID。
CI_MERGE_REQUEST_SOURCE_PROJECT_PATH11.6all合并请求的源项目路径。
CI_MERGE_REQUEST_SOURCE_PROJECT_URL11.6all合并请求的源项目的 URL。
CI_MERGE_REQUEST_TARGET_BRANCH_NAME11.6all合并请求的目标分支名称。
CI_MERGE_REQUEST_TARGET_BRANCH_PROTECTED15.2all合并请求的目标分支的保护状态。
CI_MERGE_REQUEST_TARGET_BRANCH_SHA11.9all合并请求的目标分支的 HEAD SHA。该变量在合并请求流水线中为空。SHA 仅存在于合并结果流水线中。
CI_MERGE_REQUEST_TITLE11.9all合并请求的标题。
CI_MERGE_REQUEST_EVENT_TYPE12.3all合并请求的事件类型。可以是 detachedmerged_resultmerge_train
CI_MERGE_REQUEST_DIFF_ID13.7all合并请求差异的版本。
CI_MERGE_REQUEST_DIFF_BASE_SHA13.7all合并请求差异的基本 SHA。

流水线

gitlabrunner会通过项目根目录下的.gitlab-ci.yml文件来检测并执行流水线的,那么流水线的执行过程就通过.gitlab-ci.yml文件设置的

job

https://docs.gitlab.com/ee/ci/yaml/#job-keywords

一个流水线中可以定义多个作业,每个作业的名字必须唯一(不能是关键字),每个作业独立执行,作业定义了在约束条件下进行相关操作,每个作业必须包含一个script,script以数组的形式存在;如果作业中没有before_script或after_script,若全局有,将会先执行全局的;以. 开头的作业不会被执行,一般用来模板继承

befor_script失败会导致整个作业的失败,其他作业将不会再执行,作业的失败不会影响after_script运行

job1:stage: "build"before_script:- echo "before script"script:- echo "hello job1"- echo "hello job2"after_script:- echo "after script"job2:stage: "deploy"script:- "hello job2"after_script:- echo "after script".deploystage: deploy

stages

https://docs.gitlab.com/ee/ci/yaml/#stages

流水线全局定义作业的执行的阶段,作业按照阶段的顺序执行,统一阶段的作业并行运行,不同阶段的按顺序执行

stages:- build- test- deploy# ...build:stage: "build"script:- yum install node- npm installtest:stage: "test"script:- npm run testdepoly_pod:stage: "deploy"script:- npm publish

stage

https://docs.gitlab.com/ee/ci/yaml/#stage

stage是在作业中使用的字段,用来标识当前作业的执行阶段,方便全局的stages进行调度管理,若果一个阶段有多个作业,需要注意配置多个runner,以便可以同时执行多个job

.pre&.post

.pre始终是整个流水线第一个运行的作业,.post始终是整个流水线最后运行的作业。用户定义的阶段都在两者之间运行,.pre和.post的顺序无法更改,如果流水线中仅包含.pre和.post作业,整个流水线将不会执行

test:- stage: .pretags:- buildonly:- masterscript:- echo "test..."

variables

https://docs.gitlab.com/ee/ci/yaml/#variables

定义变量,pipeline、job变量,job变量的优先级大

variables:DOMIAN: blog.domain.ccjob1:stage: "build"variables:NAME: k8sscript:- echo "$DOMAIN"- echo "$NAME"

tags

https://docs.gitlab.com/ee/ci/yaml/#tags

用于从允许运行该项目中的所有runner列表中选择指定的runner,在runner注册期间,可以指定runner标签,标签可以指定多个

job1:tags:- k8s- windows# ...job2:tags:- k8s- docker

allow_failure

https://docs.gitlab.com/ee/ci/yaml/#allow_failure

允许作业失败,默认值false,启动后,如果作业运行失败,改作业将会在用户界面中显示橙色警告,但是,整个流水将认为作业通过,并且不会阻塞后面的作业执行

job:allow_failure: truescript:- echo 22

image-20230318104441601

when

https://docs.gitlab.com/ee/ci/yaml/#when

控制作业的运行,指定作业什么状态下才会执行,选项值:

  • on_success:前面阶段中的所有作业都成功时才会执行(默认值)
  • on_failure:当前面阶段出现失败时执行
  • always:总是执行作业
  • manual:手动执行作业
  • delayed:延迟执行作业
job:when: on_successjob2:when: delayedstart_in: "20"job3:when: manaul # 手动执行,比如手动发布

retry

https://docs.gitlab.com/ee/ci/yaml/#retry

设置作业失败情况下重试的次数,只能设置正整数(0≤n≤2),最大设置次数2,也就是重试2次,总共运行3次

可以在指定类型失败情况下重试,达到精确匹配

  • always: Retry on any failure (default).
  • unknown_failure: Retry when the failure reason is unknown.
  • script_failure: Retry when the script failed.
  • api_failure: Retry on API failure.
  • stuck_or_timeout_failure: Retry when the job got stuck or timed out.
  • runner_system_failure: Retry if there is a runner system failure (for example, job setup failed).
  • runner_unsupported: Retry if the runner is unsupported.
  • stale_schedule: Retry if a delayed job could not be executed.
  • job_execution_timeout: Retry if the script exceeded the maximum execution time set for the job.
  • archived_failure: Retry if the job is archived and can’t be run.
  • unmet_prerequisites: Retry if the job failed to complete prerequisite tasks.
  • scheduler_failure: Retry if the scheduler failed to assign the job to a runner.
  • data_integrity_failure: Retry if there is a structural integrity problem detected.
job:retry: 1job2:retry:when: api_failuremax: 2job3:retry:when:- api_failure- scheduler_failuremax: 2

timeout

https://docs.gitlab.com/ee/ci/yaml/#timeout

作业级别的超时,可以超过项目级别的超时,但不能超过runner特定的超时

job:timeout: 2h 30m

parallel

https://docs.gitlab.com/ee/ci/yaml/#parallel

配置要并行运行的作业实例数,此值必须大于或等于2并且小于等于50,这将创建N个并行运行的统一作业的实例,他们从job_name 1/N到job_name N/N依次命名

job:parallel: 5

only/except

https://docs.gitlab.com/ee/ci/yaml/#only–except

only和except用分支策略来限制jobs的构建

  • only定义哪些分支和标签的git项目将会被执行job
  • except定义哪些分支和标签的git项目将不会执行job
job:only:- master

rules

https://docs.gitlab.com/ee/ci/yaml/#rules

rules允许按顺序评估单个规则,知道匹配并作为动态提供属性,不能与only/except组合使用

  • if
  • changes
  • exists
  • allow_failure
  • variables
  • when
variables:DOMAIN: example.comjob:rules:if: '$DOMAIN == "example.com"'- when: manualallow_failure: truejob2:rules:if: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME =~ /^feature/ && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME != $CI_DEFAULT_BRANCH- when: neverif: $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME =~ /^feature/- when: manualallow_failure: true

workflow

https://docs.gitlab.com/ee/ci/yaml/#workflow

顶级workflow关键字适用于整个管道,并确定是否创建管道,when:可以设置always和never,如果未提供,则默认值always

variables:DOMAIN: example.comworkflow:rules:if: '$DOMAIN == "example.com"'- when: never- when: always

cache

https://docs.gitlab.com/ee/ci/yaml/#cache

使用缓存指定要在作业之间缓存的文件和目录列表。只能使用本地工作包中的路径;管道和工作之间共享缓存。在artifacts之前恢复缓存。

cache:paths:- .yarnjob:tag:- buildcache:key: cache-buildpaths:- dist- publicpolicy: pull # 不下载缓存job2:cache:key:files:- package.json- yarn.lockpaths:- public

artifacts

https://docs.gitlab.com/ee/ci/yaml/#artifacts

用于指定在作业成功或失败时应附加到作业的文件或目录列表,作业完成后,工件将被发送至gitlab,并可在gitlab对应的ci/cd中下载

build:scripts:- ls- pwdartifacts:name: '$CI_JOB_NAME'  # 默认 artifacts.zipexclude:- node_modules/**paths:- dist- publicexpose_as: 'artifact 1' # 合并时暴露工件expire_in: 1 day  # 默认30天会清除掉reports: # 单元测试报告jest: report.xmlwhen: on_successonly:- tagsdepoly:dependencies: # 使用工件- build # job name

dependencies

https://docs.gitlab.com/ee/ci/yaml/#dependencies

定义获取工件的作业列表,只能从当前阶段之前执行的阶段定义作业,定义一个空数组将跳过下载该作业的任何工件不会考虑先前作业的状态,因此,如果它失败或是未运行的手动作业,则不会发生错误,如果设置为依赖项的作业的工件已过期或删除,那么依赖作业将失败

needs

https://docs.gitlab.com/ee/ci/yaml/#needs

可无序执行作业,无需按照阶段运行某些作业,可以让多个阶段同时运行

stages:- build- test
build1:stage: buildscripts:- ls
build2:stage: buildscripts:- pwdtest1:stage: testscripts:- npm run testneeds: ['build1'] # job nametest2:stage: test2needs:- job: 'build2'artifacts: true

include

https://docs.gitlab.com/ee/ci/yaml/#include

可以将相同的配置单独写出,在项目配置文件中引入

  • local:本地当前项目当前分支的文件
  • file:gitlab其他项目其他分支的某个文件
  • remote:远程文件,http://example.com/xxx/.gitlab-ci.yml
  • template:使用官方的模板,https://gitlab.com/gitlab-org/gitlab/-/tree/master/lib/gitlab/ci/templates
# deploy.yml
deploy:stage: deployscripts:- echo deploy
# .gitlab-ci.yml
include:local: 'deploy.yml' # 当前项目当前分支下的文件# fileproject: fontend/web-demo # gitlab下指定的项目ref: master  # 分支file: .gitlab-ci.yml# template 使用官方的模板template: npm.gitlab-ci.yml# remoteremote: <http://example.com/xx/.gitlab-ci.yml>

extends

https://docs.gitlab.com/ee/ci/yaml/#extends

继承其他作业的配置

.tests:script: rake teststage: testonly:refs:- branchesrspec:extends: .testsscript: rake rspeconly:variables:- $RSPEC

trigger

https://docs.gitlab.com/ee/ci/yaml/#trigger

多项目管道、父子管道

image

https://docs.gitlab.com/ee/ci/yaml/#image

默认在注册runner的时候需要填写一个基础镜像,只要使用执行器为docker类型的runner所有的操作运行都会在容器中运行,如果全局指定了image则所有的job使用此image创建容器并在其中运行,全局未指定image,再次检查job中是否指定,如果有此job按照指定镜像创建容器并执行,没有则使用注册runner时指定的默认镜像

image:node:alpineentrypoint: ["node -v"]job:stage: buildscripts:- npm install- npm run build

services

工作期间运行的另一个docker镜像,并link到image关键字定义的docker镜像,这样就可以在构建期间访问服务镜像,服务镜像可以运行任何应用程序,但是最常见的是运行数据库容器,

image:node: alpineservices:- name: mysql:latestalias: mysql

environment

https://docs.gitlab.com/ee/ci/yaml/#environment

定义job发布的环境

depoly:scripts:- npm login- npm publishenvironment:name: productionurl: <https://www.baidu.com>

inherit

https://docs.gitlab.com/ee/ci/yaml/#inherit

使用或禁用全局定义的环境变量或默认值

default:retry: 2image: node:alpinevariables:NODE_VERSION: 16.2.1USER_NAME: rootjob1:script: echo helloinherit:default: false # 禁止使用default变量variables:- NODE_VERSION # 继承变量 NODE_VERSIONjob2:script: echo job2inherit:default:- retry # 继承retryvariables: false # 禁止使用variables变量

参考文档

  • https://docs.gitlab.com/ee/ci/
  • https://docs.gitlab.com/ee/ci/yaml/

由于格式和图片解析问题,为了更好阅读体验可前往 阅读原文


http://www.ppmy.cn/embedded/154204.html

相关文章

排序算法的实现(插入,希尔,选择,冒泡,堆排,快排)

目录 1.选择排序 2.冒泡排序 3.堆排序 4.插入排序 5.希尔排序 6.快排 6.1快排的优化 6.2快排&#xff08;双指针法&#xff09; 6.3快排&#xff08;非递归&#xff09; 7.归并排序 7.1归并非递归 8.计数排序 1.选择排序 对n个元素进行选择排序&#xff0c;我们可以…

计算机网络 | 什么是公网、私网、NAT?

关注&#xff1a;CodingTechWork 引言 计算机网络是现代信息社会的基石&#xff0c;而网络通信的顺畅性和安全性依赖于有效的IP地址管理和网络转换机制。在网络中&#xff0c;IP地址起到了标识设备和进行数据传输的核心作用。本文将详细讨论公网IP、私网IP以及NAT转换等网络技…

.NET Core NPOI 导出图片到Excel指定单元格并自适应宽度

NPOI&#xff1a;支持xlsx&#xff0c;.xls&#xff0c;版本>2.5.3 XLS&#xff1a;HSSFWorkbook&#xff0c;主要前缀HSS&#xff0c; XLSX&#xff1a;XSSFWorkbook&#xff0c;主要前缀XSS&#xff0c;using NPOI.XSSF.UserModel; 1、导出Excel添加图片效果&#xff0…

线程间通信

线程间通信&#xff08;Inter-Thread Communication, 简称ITC&#xff09;是指在多线程编程中&#xff0c;不同线程之间如何交换信息或协调彼此的行为。良好的线程间通信机制是构建高效、可靠的并发程序的关键。Java语言提供了多种内置工具和库来支持线程间的通信&#xff0c;包…

基于mediapipe的手势游戏控制

基于mediapipe的手势游戏控制 ​ 玩游戏&#xff0c;那不是有手就行!!! mediapipe介绍 ​ Mediapipe是Google在2019年开发并提出的一款开源的跨平台多媒体处理框架&#xff0c;用于构建基于机器学习的应用程序&#xff0c;特别是涉及到计算机视觉、音频处理、姿势估计等领域。…

汽车故障码U007388 PCAN Bus OFF 解析和处理方法

一、故障码解析 含义&#xff1a; U007388 是一个汽车故障码&#xff0c;“U” 开头的故障码一般涉及网络通信故障。PCAN&#xff08;Power Control Area Network&#xff09;通常是指动力控制局域网。“Bus OFF” 表明该网络处于离线状态&#xff0c;意味着 PCAN 网络中的某些…

leetcode 87. 扰乱字符串

题目&#xff1a;87. 扰乱字符串 - 力扣&#xff08;LeetCode&#xff09; dfs状态记录。 dfs&#xff1a;以两个字符串 [a1,a2,a3,a4] 和 [b1,b2,b3,b4]为例&#xff0c;可以往下搜以下几种情况&#xff0c;一种情况为true就能返回true F([a1],[b1]) && F([a2,a3,a4…

Linux 常见运营维护,从安装软件开始,到mysql,php,redis,tomcat等软件安装,配置,优化,持续更新中。。。

下载centos7 CentOS 7 完整版&#xff08;DVD&#xff09;&#xff1a; https://mirrors.aliyun.com/centos/7/isos/x86_64/CentOS-7-x86_64-DVD-2009.isoCentOS 7 最小化版&#xff08;Minimal&#xff09;&#xff1a; https://mirrors.aliyun.com/centos/7/isos/x86_64/C…