GA

GitHub Actions 生成

勾几下就出一份能跑的 CI 工作流

GitHub 的 cron 一律按 UTC 解释,北京时间要减 8 小时。想每周一 11:00 跑就写 0 3 * * 1。

                

如何使用本工具

  1. 先填工作流名称和分支,勾掉不需要的触发器,只留用得上的。
  2. 选技术栈后会自动填一个常用版本号,按项目实际版本改。
  3. 缓存默认开启,setup-node / setup-python / setup-go / setup-java 都支持。
  4. 按需勾上代码检查、测试、构建、上传产物、推 Docker 镜像,输出会实时重算。
  5. 复制 YAML,在仓库里新建 .github/workflows/ci.yml 粘贴保存,push 后即生效。

常见问题

Q:为什么 on: 后面不能写成 on: [push]?

A:能写,但配分支过滤就必须用对象形式。on: push 与 on: [push, pull_request] 都合法,只是没法再加 branches 子键。本工具输出的是对象形式,方便以后按分支或路径加过滤条件。

Q:定时任务的 cron 时间为什么总对不上?

A:GitHub 的 schedule 一律按 UTC 解释,不看仓库或运行环境时区。北京时间 11:00 要写成 0 3 * * 1。另外定时任务只跑默认分支,仓库连续 60 天没有提交会被自动暂停,需要手动去 Actions 页面重新启用。

Q:为什么 pnpm 项目要单独加一步 action-setup?

A:因为 actions/setup-node 的 cache: pnpm 需要调用 pnpm 命令去算缓存键,而 runner 上默认没有 pnpm。如果直接把 setup-node 写在前面,会报 Unable to locate executable file: pnpm。顺序必须是 pnpm/action-setup 在前、setup-node 在后。

Q:npm test 在没有测试脚本时会失败吗?

A:会。npm test 本质是 npm run test,package.json 里没有 test 脚本就返回非零退出码,整条流水线红掉。所以本工具统一加 --if-present,找不到脚本就跳过而不报错。

Q:推镜像到 ghcr 为什么报 invalid reference format?

A:因为 ghcr 要求仓库路径全小写,而 github.repository 保留仓库原始大小写。仓库叫 MyApp 时 ghcr.io/owner/MyApp 会被拒绝。要么把仓库名改小写,要么在前面加一步用 bash 把字符串转小写再输出成变量。

Q:cache: npm 缓存的是什么?

A:缓存的是 npm 的全局下载缓存(~/.npm),不是 node_modules。命中缓存能省下从 registry 拉包的时间,但 npm ci 仍会重建 node_modules。想连 node_modules 一起缓存要自己用 actions/cache,一般不推荐,容易和 lockfile 不一致。