简体中文
审查生命周期
可复用 workflow .github/workflows/review.yml 决定何时审查,每个仓库从自己的 eyeful.yml 调用它。每次审查是一个 job;同一个 pull request 同时最多跑一个。
| 机制 | 行为 |
|---|---|
| 一次 | pull request 打开或转为可审查时审查。草稿不审。 |
| 命令 | 在打开的 pull request 上,内容是 /eyeful、或以 /eyeful 加空格或换行开头的评论,会审查它当前的 head。job 开始时会给这条评论回 👀。 |
| 谁可以 | 只有关联身份为 OWNER、MEMBER 或 COLLABORATOR 的 pull request 作者或评论者能发起审查。 |
| 排队 | 每个 pull request 一个 concurrency 组,新审查排在正在运行的之后;更新的命令会替换还在排队的那个。 |
| 已关闭 | 在已关闭的 pull request 上评论命令,job 直接结束,不做审查。 |
| CI | 审查等待 head 提交上的 workflow 运行结束,但跳过它自己所属 workflow 的所有运行,所以之前失败或取消的 eyeful 运行不会被当成项目的 CI。 |
| 状态 | 不论由哪种事件触发,job 都会在 pull request 的 head 提交上设置 eyeful 状态:先是带运行链接的 pending,发布审查后为 success,没发布为 failure,job 被取消为 error。 |
| 重新运行 | 重新运行 job 会从头审查,只发布缺少的内容。 |
| 超时 | job 120 分钟后停止。 |
| 沙箱 | 每次审查有自己的沙箱容器,job 结束时删除。 |
还没做的
- 审查在 job 里等 CI,pull request 的检查跑着时一直占用一台 runner。
- 由命令触发的审查还不会复用上一次审查的发现。
