Help us learn about your current experience with the documentation. Take the survey.

验证 GitLab CI/CD 配置

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

使用 CI Lint 工具检查 GitLab CI/CD 配置的有效性。 你可以验证 .gitlab-ci.yml 文件或任何其他示例 CI/CD 配置的语法。 这个工具会检查语法和逻辑错误,并可以模拟流水线创建,以尝试发现更复杂的配置问题。

如果你使用 流水线编辑器,它会自动验证配置语法。

如果你使用 VS Code,你可以使用 VS Code 的 GitLab Workflow 扩展 来验证你的 CI/CD 配置。

检查 CI/CD 语法

CI Lint 工具会检查 GitLab CI/CD 配置的语法,包括使用 includes 关键字 添加的配置。

使用 CI Lint 工具检查 CI/CD 配置:

  1. 在左侧边栏,选择 搜索或跳转至 并找到你的项目。
  2. 选择 构建 > 流水线编辑器
  3. 选择 验证 标签页。
  4. 选择 Lint CI/CD 示例
  5. 将你想要检查的 CI/CD 配置副本粘贴到文本框中。
  6. 选择 验证

模拟流水线

你可以模拟创建 GitLab CI/CD 流水线,以发现更复杂的问题,包括 needsrules 配置的问题。模拟会在默认分支上以 Git push 事件的形式运行。

前置条件:

  • 你必须拥有 权限 才能在此分支上创建流水线以进行模拟验证。

模拟流水线:

  1. 在左侧边栏,选择 搜索或跳转至 并找到你的项目。
  2. 选择 构建 > 流水线编辑器
  3. 选择 验证 标签页。
  4. 选择 Lint CI/CD 示例
  5. 将你想要检查的 CI/CD 配置副本粘贴到文本框中。
  6. 选择 为默认分支模拟流水线创建
  7. 选择 验证