首页/开发/CI/CD 与发布速查/GitLab CI 的 .gitlab-ci.yml 结构
工具链要点63 条

GitLab CI 的 .gitlab-ci.yml 结构

GitLab 流水线配置文件:声明 stages 与作业(job),每个作业指定 stage、script 与运行条件;作业名即流水线中的显示名。

CI/CD 与发布速查开发更新于 2026-10-12
位置仓库根目录 .gitlab-ci.yml
默认阶段未声明 stages 时使用 build / test / deploy
作业核心键stage、script、image、rules
全局键default、workflow、include、stages、variables

最小流水线

最小流水线
stages: [build, test, deploy]

build-job:
  stage: build
  script:
    - make build

test-job:
  stage: test
  script:
    - make test
阶段决定作业顺序,同阶段作业默认并行;跨阶段依赖可用 needs 改成 DAG。

易错点

  • script 各行在同一 shell 会话中执行:cd 与 export 会延续到后续行,需要隔离时用子 shell
  • 把逻辑都塞进一个巨型作业:阶段与并行能力被浪费,失败定位困难

数据来源与参考

  • GitLab Docs《CI/CD YAML syntax reference》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌