Skip to content

ci: 新增 proto 自举门禁 job(dogfood gates) - #37

Merged
kooksee merged 2 commits into
mainfrom
ci/proto-selfcheck
Nov 16, 2026
Merged

kooksee merged 2 commits into
mainfrom
ci/proto-selfcheck

Conversation

@kooksee

@kooksee kooksee commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

改了什么

在仓库自身 CI(.github/workflows/ci.yml)新增 proto job,用 protobuild 自己的命令对本仓库 proto/ 与 vendor 产物做自举门禁:

vendor → verify → format --exit-code → lint → breaking --error-format github-actions

同步更新 AGENTS.md 的 CI 描述。

关键设计点

  • protoc 用官方 release zip 装到 /usr/local(pin v36.2):protobuf.yaml 的 google/protobuf 依赖是本地路径 /usr/local/include/google/protobuf,apt 的 protobuf-compiler 装在 /usr/include 对不上,这是 CI 化最容易踩的坑
  • buf pin v1.74.0:format 默认引擎与 breaking 需要 buf 二进制(lint 引擎内置,无需安装)
  • checkout fetch-depth: 0:breaking 缺省物化 origin/main 作 base,浅检出没有该 ref
  • 缓存 ~/.cache/protobuild/deps,key 按 protobuf.yaml 哈希
  • 全部走 go run .(Taskfile 同款惯例):门禁盯的是当前 PR 代码的行为,而非已发布二进制

验证

  • 四条门禁本机全绿(macOS,protoc 33.4 / buf 1.74.0)
  • actionlint 对新 job 零告警(剩余 2 条 setup-go@v4 过旧告警为基线 lint/test job 自带;新 job 用 v5)
  • AGENTS.md 命令表守卫测试不受影响(无新增子命令)

没做的(可后续)

  • gen 同步门禁(protobuild gen && git diff --exit-code):需要 CI 装 protoc 插件(go/retag),是整条链最重的部分,本次按轻量方案先不引入
  • 旧 lint/test job 的 setup-go 升级 v5

追加:修复 gomod 源解析 bug(d95f1ee)

首次 CI 真跑暴露出 protobuild 自身 bug:depresolver.NewManager 用 os.Getenv("GOPATH") 推导模块缓存目录,GitHub runner 不导出 GOPATH → 得到相对路径 pkg/mod → vendor 校验报 "subdirectory 'proto/retag' not found in module"。

修复:解析优先级改为 go env GOMODCACHE(权威,反映 go get 实际落盘)> $GOPATH/pkg/mod > $HOME/go/pkg/mod;带 TDD 回归测试(TestNewManagerGomodPathWithoutGopathEnv、TestResolveGomodPath),本地已用 env -u GOPATH go run . vendor 复现并验证修复。

- CI 用官方 protoc release zip 解到 /usr/local:protobuf.yaml 的 google/protobuf
  依赖是本地路径 /usr/local/include,apt 的 protobuf-compiler 装在 /usr/include 对不上
- 安装 buf v1.74.0(format 默认引擎与 breaking 依赖;lint 引擎内置)
- checkout fetch-depth: 0:breaking 缺省物化 origin/main 作 base
- 缓存 ~/.cache/protobuild/deps,key 按 protobuf.yaml 哈希
- 四条门禁已本地验证全绿(macOS,protoc 33.4 / buf 1.74.0)
原实现 os.Getenv("GOPATH") 为空时 filepath.Join 得到相对 "pkg/mod",
GitHub runner 上不导出 GOPATH,导致 vendor 解析 gomod 源时校验
"subdirectory not found"(protobuild PR#37 proto job 实测复现)。

解析优先级:go env GOMODCACHE(权威,反映实际 go get 落盘位置)
> $GOPATH/pkg/mod > $HOME/go/pkg/mod(go 的默认)。
@kooksee
kooksee merged commit b3f2f58 into main Nov 16, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant