.gitlab-ci.yml 生成
流水线分阶段生成,YAML 结构当场校验
stages 顺序固定为 build → test → lint → deploy,未勾选的阶段不会生成作业。
如何使用本工具
- 选项目语言和镜像版本,工具会自动填好 default.image 与对应的锁文件、缓存目录。
- 勾选需要的阶段,并把安装、lint、build、test、deploy 命令填进对应输入框,每行一条。
- 右侧实时生成 .gitlab-ci.yml,结构检查会报出未声明的 stage、Tab 缩进和缺失的 coverage 配置。
- 部署阶段默认生成 rules + when: manual,避免每次推送都自动上线。
- 复制或下载文件放到仓库根目录,推上去 GitLab 就会自动识别流水线。
常见问题
Q:GitLab CI 的 stages 顺序能随便改吗?
A:能,但同一 stage 里的作业是并行跑的,只有不同 stage 之间才保证先后顺序。所以常见的顺序是 build → test → deploy,把 lint 和 test 放同一 stage 可以让它们并行、缩短流水线时间。工具固定 build → test → lint → deploy,需要调整可直接改生成结果里 stages 列表的顺序。
Q:before_script 和 script 有什么区别?
A:before_script 在每个作业的 script 之前执行,且和 script 在同一个 shell 里,所以 cd、export 之类的前置动作放这里有效。但它是 default 级的,所有作业都会跑一遍;只想让某个作业跑的命令应该写进那个作业自己的 script。作业里也能定义自己的 before_script 来覆盖 default。
Q:cache 的 key.files 是干什么的?
A:它让 GitLab 用指定文件的内容哈希当缓存 key:锁文件没变就复用缓存,锁文件一变就自动换新缓存,避免依赖升级后还命中旧 node_modules。比固定 key 安全,比按分支分缓存省空间。policy: pull-push 表示作业既读又写缓存,只给构建作业写、其他作业读时可以改成 pull。
Q:coverage 正则怎么匹配 Jest 输出?
A:GitLab 用这个正则去作业日志里找第一个捕获组当覆盖率数字。Jest 的 text-summary 会输出类似 All files | 87.5,工具给的 '/All files\s*\|\s*([0-9.]+)/' 就是匹配它。用别的测试框架要按它的输出格式改正则,否则覆盖率徽章会一直显示 unknown。
Q:为什么 deploy 作业加了 when: manual?
A:部署属于有副作用的操作,通常不希望每次合并都自动触发。when: manual 让它在流水线页面变成一个可点按钮,配合 rules 限定只在默认分支出现。需要全自动部署时删掉这一行,或改成 when: on_success。
Q:YAML 里为什么不能用 Tab 缩进?
A:YAML 规范明确禁止用 Tab 做缩进,只允许空格,GitLab 的解析器遇到 Tab 会直接报 mapping values are not allowed 之类的错误,而且错误信息经常指不到真正的行。工具在结构检查里会扫全文的 Tab 并报错。