GitLab同项目不同目录下local include的正确语法咨询

你的项目结构如下：

project-fancy-name
    -> jobs
        -> build
            - build-maven.yml
        -> defaults
            - maven-defaults.yml

你尝试在build-maven.yml中引入maven-defaults.yml，试了多种相对路径写法都报Local file defaults/maven-defaults.yml does not exist!错误，但均未生效。

正确写法 #

GitLab CI的local路径是相对于项目根目录的，而非当前YAML文件所在的子目录，因此你需要使用从根目录出发的完整相对路径：

include:
  - local: jobs/defaults/maven-defaults.yml

错误原因说明 #

你之前用../defaults/maven-defaults.yml这类基于当前文件的相对路径写法是无效的——GitLab CI解析local路径时，始终以项目根目录作为起点，不会参考当前YAML文件的所在位置。

内容的提问来源于stack exchange，提问作者Popeye