CI 检出所有权
检出所有权¶
共享的 Linux Node 检出(linux_node_checkout_step)和共享的 Windows/macOS/iOS 检出(platform_checkout_step)在这些锚点内的每个 Git 命令都使用一个进程所有者。Linux 允许五次完整检出尝试,每次尝试前都会清理工作区,候选和受信任的工作流 harness 获取截止时间均为 120 秒,并采用递增的五秒退避。Windows、macOS 和 iOS 保留 90 秒获取截止时间,仅在超时时进行三次候选获取尝试,五秒退避,以及一次 harness 获取尝试。候选版本和 harness 版本保持分别固定;当它们完全匹配时,所有者仅将新检出索引中的受跟踪 action 文件复制到独立的 harness 目录,而不再进行获取或索引更新。版本不同时,仍保留单独的稀疏、无 blob 的 harness 获取。Linux 还会为棘轮检查、协议检查、PR 临时报告和变更的 npm-lock 检查,以深度一获取可选的比较基线。
唯一维护的所有者实现是 .github/actions/git-owner/owner.py。pnpm ci:git-owner:gen 将它生成到 ci.yml 中唯一的检出前 Python heredoc 中;pnpm ci:git-owner:check、工作流检查以及 Git 边界测试通道会拒绝漂移。独立的 composite action 将其自身受信任的字节复制到唯一的 runner 临时目录,并发布 owner-path 和 CI_GIT_OWNER。两个引导程序都不会从选定的候选版本加载所有者。两者都使用隔离的 Python(-I -S),且仅使用其标准库,无需 Git 或网络引导。
超时、取消和领导者退出会在工作区删除、另一个 Git 命令或步骤完成之前,排空所拥有的 POSIX 进程组或 Windows Job Object。清理有十秒宽限时间,独立于操作截止时间。POSIX 清理使用受检进程普查来区分已终止的僵尸进程与存活的写入进程。只有当该普查证明没有存活成员时,才会接受被拒绝的组信号;存在存活或未知状态时,仍然按 fail-closed 方式失败。检查失败后,KILL 之后会在剩余清理宽限时间内观察进程组是否消失;仅等待领导者是不够的。检查或清理失败会关闭所有者并以退出码 125 退出;同一策略中的后续调用无法启动 Git。一旦清理成功,取消优先于超时或普通 Git 失败,包括在排空期间收到的取消。仅凭获取超时本身并不能解释传输为何停滞。
最终异常边界以退出码 125 退出,并将 [ci-git-owner] diagnostic= 记录追加到现有 fail-closed 注释中。诊断最多报告四个异常,按显式原因优先于隐式上下文的顺序展开,并在可用时提供已知异常类型和有界整数 errno/winerror 值。每个异常最多包含六个所有者源码函数名和行号;这些标识固定所有者修订版中的调用。每个异常的 traceback 帧遍历在 256 帧后停止,并标记截断。策略帧、路径、消息、参数、命令、环境和凭据会被省略。未知异常类型标记为 unknown;诊断失败报告 unavailable,且不会替换最终退出。仅在链中存在 FetchTimeout 时报告。没有此证据的早期失败仍保留未知原因;仅凭经过的时间或退出码 125 无法确定超时或某个具体的失败 API。
直线调用者使用 --git <seconds> <args>;零表示没有操作截止时间。恢复策略在同一 Python 进程中使用 --policy <trusted-python-file> 或 --policy -(来自 stdin 的受信任源码),并从 ci_git_owner 导入 run_git、git_output、GitFailure 和 FetchTimeout。策略只捕获普通 Git 失败和操作超时。普通 Git 的退出码 125 和 143 在该类型化边界内与所有权失败和取消仍是不同的;仅凭 shell 退出码无法区分它们。通用 Git 和策略调用不需要 GitHub 或 runner 环境。run_git 接受输出流和命令级环境覆盖,且不持久化 Git 配置;清理始终使用共享的十秒宽限时间。Git 的标准输入始终为 DEVNULL。git_output 返回精确的 UTF-8 文本,对无法解码的字节使用代理转义,保留空白和 NUL 分隔符;只有检出 ref 解析会裁剪输出。内联策略允许运行中的工作流向固定所有者提供自身的受信任策略,而无需从选定的检出中导入代码。
Preflight、manual security、Python skills、ClawHub docs source 和 Android 都复用该所有者。Preflight 和 Python skills 保留三次仅在超时时进行的深度一获取尝试;manual security 保留深度二及其不可用目标回退。Preflight 会在任何 Git 失败时单独重试深度二的无 blob 父元数据,并且即使事件 ref 移动,也会验证所请求的精确 SHA。ClawHub 和 Android 保留五次完整检出尝试:仅清理 ClawHub 的源目录以用于文档,而 Android 会清理其候选工作区并要求可执行的 Gradle wrapper。当版本匹配时,Preflight 会在完整候选检出后复用该索引导出;版本不同时,在候选 SHA 解析后保留固定的 Actions 检出及其现有的传输/重试契约。Android 保留其单独的受信任 harness 检出。
安全扫描在第一次经过身份验证的检出期间、也就是在检出移除凭据之前,获取其由 PR 数量派生的历史记录。协议检查、PR 临时报告和变更的 npm-lock 检查同样消费在检出期间准备好的精确比较 SHA,之后不再进行基线获取。不支持变更检查的手动 npm-lock 分发和目标保留完整扫描。ci.yml 中其余的补充获取使用 runner 临时目录中的工作流自有引导,绝不使用来自选定候选版本的辅助程序。发布门禁棘轮保留六次合并快照尝试;清理不确定性或取消会停止消费者。Preflight 通过经过身份验证的 GitHub API 调用解析默认分支和发布 ref,然后将解析出的 SHA 传递给缓存分类和 manifest 规划器。修正基线查找在候选版本自身的代码运行之前完成,其令牌保留在 manifest 步骤之外。
锁回收与进程所有权是分开的。checkout 和 base-fetch 策略仅对其独占拥有的 checkout 传递 reclaim_locks=True;补充性 CI 抓取则选择等效的 --checkout-git <seconds> <args> 入口点。在抓取失败或终止并验证进程树消亡后,所有者会移除物理 Git 元数据中新建的锁;预先存在的锁和关联元数据保持不变。通用 Git 调用不认领元数据,因此只读命令在关联 worktree 中同样可用。
共享的 ensure-base-commit action 从其自身的 action 包中解析相邻的所有者,并在进程中运行其可用性/恢复策略。它保留 30 秒的抓取截止时间:在深度为一处使用精确 SHA,然后依次加深 25、100、300 和 1000。如果 base 仍然缺失,仅在 checkout 仍为浅克隆时,最终 ref 抓取使用 --unshallow;完整 checkout 使用普通 ref 抓取。显式抓取请求 --filter=blob:none。可用性和浅状态检查使用命令局部的 GIT_NO_LAZY_FETCH=1,因此隐式 promisor 抓取无法超出这些预算;下游对象读取保持正常的惰性填充。可用性检查在成功抓取和普通失败后执行,但绝不在取消或未经验证的清理之后执行。
Workflow Sanity 是首个外部固定版本的类型化策略采用者:在 Python 3.12 设置之后,它准备 git-owner@dd4528b6393e7d00063067a080ca7241b48ce475 并内联提供受信任的审计配置策略。已存在的 base commit 会跳过传输。否则,其独占拥有的 checkout 启用锁回收,同时保留 30 秒的抓取截止时间、每个 ref 最多三次尝试,以及仅在超时或普通 Git 124/137 重试之间的五秒取消感知退避。普通的精确 SHA 失败或重试耗尽允许分支回退;所有权失败或取消则不允许。每个配置独立选择精确 SHA 或现有远程分支,并允许无限制的本地读取;环境路径仅在两个配置和 Zizmor 路径重写均成功后才发布。
QA Profile Evidence 是 git-owner@dd4528b6393e7d00063067a080ca7241b48ce475 的另一个固定版本最终采用者。每个使用 Git 的 job 使用既定的系统 Python 引导程序,在后续 checkout 之外准备所有者。其四个验证/协议抓取保留 120 秒的操作截止时间;其六个受信任 harness 和选定源的引导抓取不保留操作截止时间。全部十次调用均使用线性 --checkout-git 调用且仅尝试一次,因此所有权失败或取消会在下游 checkout、回读或发布之前停止。被调用工作流身份和选定源信任分类保持分离且不变。
Mantis ref 校验使用相同的固定版本所有者。共享的 mantis-validate-trusted-ref action 拥有一次无限制的 main 抓取,即使同时存在 baseline 和候选 ref。Discord 冒烟校验拥有两个抓取点,截止时间为 120 秒:先抓取 main,然后在需要时抓取精确的 release 分支。每次抓取仅尝试一次,并且必须在信任检查或输出之前排空。校验器保留不同的信任策略和输出契约;Discord release 分支不匹配绝不会回退到 PR 查找。
Mantis 安装程序和 worktree 准备也使用该固定版本所有者,在每个运行 job 中于 harness checkout 之后立即准备。Discord 状态反应和线程附件保留其两个深度为一的 Crabbox 克隆,通过 --git 120 设置 120 秒截止时间。Slack 桌面版保留 init、remote-add、一次深度为一的 main 抓取以及分离的 FETCH_HEAD checkout;只有其抓取有 120 秒截止时间。所有六个 worktree 添加(涵盖状态反应、线程附件、Slack 桌面版和 Web UI 聊天证明)均通过 harness checkout 使用 --checkout-git 0。本地 init、remote-add、checkout 和 worktree 操作没有操作截止时间。所有权失败或取消具有终止性,后续 Git 操作、Go/pnpm 构建、检查或输出都不会执行。当前没有任何 Mantis Git 调用使用 GNU timeout。
Security Review 在两个 job 中均使用固定版本 checkout action 的稀疏选择和自动 blobless 抓取。解析器选择 scripts/github/security-review-event.mjs、scripts/github/guard-shared.mjs 和 scripts/lib/bounded-response.mjs。审查 job 选择 scripts/github 下的 dependency-guard.mjs、guard-review.mjs、guard-shared.mjs、security-review-policy.mjs、security-review-rollout.mjs、security-review.mjs 和 security-sensitive-guard.mjs,外加 scripts/lib/bounded-response.mjs 和 .github/security-review-policy.yml。它还选择 .github/actions/setup-security-review 下的 action.yml、package.json 和 package-lock.json。非 cone 模式排除无关的产品文件和根清单。两个 job 均保留深度为一、受信任的事件 checkout,不显式覆盖 ref 或仓库,并设置 persist-credentials: false。PR 内容来自 GitHub API。每个 job 对失败的受信任 checkout 重试一次,保持相同的稀疏选择和受信任修订版本。恢复的第一次尝试不会导致 job 失败。Security Review job 最多允许 85 分钟,涵盖两次五分钟的 checkout 尝试、三分钟的运行时设置和有界的 API 配额恢复。如果审查 job 的 checkout 或运行时设置失败,独立于 checkout 的发布器会将计划中的当前 head 标记为失败,而不是让其组合门禁保持待处理状态。它跳过已关闭的 PR 和被取代的 head,并且绝不发布成功。
Docs Sync Publish Repo 仅 checkout docs、scripts 和 .github/codex/prompts,以及 cone 模式稀疏 checkout 包含的根文件。固定版本 checkout action 对此选择使用 blobless 抓取:提交历史仍然可用,但无关的应用文件和历史文件内容不会被下载。保持 fetch-depth: 0,因为过期源检查需要完整的祖先历史,以避免用较旧的快照替换较新的已发布文档。这减少了源 checkout 的工作量;它不会改变排队、完整 MDX 校验或下游站点构建。
Docs Sync Publish Repo 在源代码和 ClawHub 检出之后准备相同的固定所有者,并在 Node 设置之前使用系统 Python。其内联类型化策略拥有克隆及关联发布链。克隆和两个抓取位置均保留 120 秒的操作期限;克隆和发布保留五次尝试,退避时间为 2/4/6/8/10 秒,包括最后一次失败的尝试。只有普通 Git 失败或 FetchTimeout 才允许在经过验证的清理之后进行重试。建议性的提交前抓取可能失败,并可安全地继续提交;发布失败时首先尝试一次所属的变基中止。变基、推送、本地读取以及 config/add/commit 保持无时限。ClawHub HEAD 必须在同步脚本使用它之前完整地通过所有者。清理不确定性、设置失败或取消在重试、中止、另一次删除或使用之前是终结性的。只有固定的发布路径会被替换,且不跟随其符号链接;独占发布操作回收新创建的锁,同时保留现有锁。队列并发、过期源检查和“无变更成功”保持不变。
Docs Agent 在检出后立即准备相同的固定所有者。两个受信任的内联门策略在不变的 shell GitHub/JQ 节奏块之前和之后拥有 Git;手动调度和已被取代的 CI 在该查询之前退出。关联的提交策略拥有 diff、config、暂存、提交、抓取、推送和陈旧主分支回读。门和提交各自保留五次 fetch --no-tags 尝试,具有 120 秒的期限和独占检出锁回收。门退避时间为 2/4/6/8 秒,仅在尝试之间;提交抓取和推送失败保留 2/4/6/8/10 秒,包括最后一次失败。本地读取、仅文档强制生产者、config/add/commit 和推送保持无时限。只有类型化的普通 Git 失败或 FetchTimeout 才允许在经过验证的清理之后走现有恢复路径;设置、统计、清理失败和取消在重试、回退、输出或下游工作之前是终结性的。一小时节奏、REST .id 当前运行排除、已取消/已跳过排除和审阅基线排序保持不变。
生成的 PR 发布在铸造令牌之前准备相同的固定所有者。一个受信任的操作策略拥有从暂存、提交、重叠/失效检查、租用推送、协调到认证清理的每一项 Git 操作。分支头查找和推送保留 60 秒期限;基础抓取保留 120 秒;本地 Git 保持无时限。没有通用的 Git 重试或退避。只有现有的删除竞争才允许在观察到的非空头消失之后进行一次全新基础重建和一次仅创建推送。类型化的普通 GitFailure 和 FetchTimeout 仅在经过验证的清理之后才允许该语义恢复;仅状态 125 或 143 无法识别所有者失败或取消。Git 读取失败不能变成无重叠或已合并树成功。清理不确定性或取消会在另一个 Git/GH 命令、回退、输出消费、摘要或认证清理成功之前停止。GitHub CLI 命令保留其现有的 GNU timeout 和协调策略。发布者仍然是 Control UI 区域设置、原生区域设置、CI 时序调整和成熟度发布的最终步骤。过期的生成器运行保留现有拉取请求及其提交,禁用继承的自动合并,并交由新的运行处理(或在调用方要求时失败)。它们绝不会清空自动化分支来关闭拉取请求。一次当前的无变更运行不会干预待处理的工作;经过验证的继任者会恢复配置的精确头 squash 自动合并策略。GitHub 没有按头条件禁用的操作:并发头移动会导致协调失败,而不会覆盖继任者,可通过重新运行其发布者来重新启用。必需的检查和仓库保护仍然管辖合并。
原生区域设置新鲜度遵循原生源和清单、共享术语表和翻译辅助工具、平台生成器以及发布工具。Control UI 目录和配置模式更改仍是 Control UI 刷新的输入。共享翻译辅助工具仅为 UI 命令加载 UI 目录和验证代码,因此 UI 提示的更改不会丢弃本来已经是当前版本的原生输出。两个调用方都保留相同的发布者新鲜度和所属输出重叠检查。
Maturity Scorecard 在所选引用检出之前立即准备该不可变所有者,并在检出过程中保留其运行器临时环境交接。其受信任的内联策略拥有完整的验证决策。主分支、发布分支和发布基础的抓取以及所有本地检查保持无时限,仅一次尝试。唯一的 60 秒操作是 ls-remote --exit-code --heads:普通状态 0 选择该分支,状态 2 保留默认分支,其他所有状态在清理后都会以查找诊断失败。超时不等于不存在;所有者失败和取消绝不会选择回退或发布输出。主分支祖先、发布标签和精确发布分支头的信任排序、浮动主分支冻结、发布祖先和被排除路径差异检查以及发布哈希字节均保持不变。
Linux App Release、macOS Release 和 NPM Placeholder Bootstrap 在选择源检出之前准备相同的固定所有者。Linux 保留一次 fetch --quiet origin main,期限为 120 秒,然后在本地执行标签剥离和主分支祖先检查,无操作期限;普通祖先非零结果保留现有的主分支可达性拒绝,而生命周期失败或取消无法发布 tag_sha。macOS 保留其无时限的 rev-parse HEAD、精确的强制公共分支 refspec、检出持久化的读取认证,以及在元数据检查器之前的一次 120 秒抓取。NPM Placeholder 在检出检查之前保留非 Git 工作流/目标身份拒绝,一次 120 秒的强制主分支抓取,以及在发布不可变目标 SHA 之前的两次无时限祖先检查。以上流程均未添加重试或退避。macOS 元数据检查器单独拥有的十分钟祖先子进程仍在此显式工作流-Git 采用范围之外。
Plugin ClawHub Release 和 Plugin NPM Release 也会在选中的或受信任的 checkout 之前准备该 owner。ClawHub 保留其 main/release 获取和可选的 release-tag 获取,各自带有 120 秒截止时间;npm 保留其 extended-stable、main/release、preflight-readback 和 publish-readback 的 120 秒获取。本地检查、ref 枚举、祖先关系、checkout 和对象读取保持无限制。ClawHub 在普通检查失败被安全排空后,保留从本地到 origin 的 ref 回退;解析出的提交仍必须通过独立的 OIDC 身份和祖先关系检查。只有 merge-base 状态 1 才会推进到下一个信任源;其他祖先关系错误和 release-ref 枚举失败都是终止性的。owner 失败和取消在整个过程中都是终止性的,包括在 ref 解析期间。精确的源 package.json 字节仅在 fetch 和 git show 排空之后写入,且在哈希或发布证据消费之前。不会添加 Git 重试或退避,npm 单独的 300 秒 token-bootstrap 发布截止时间保持不变。由 push 触发的插件范围发现和 manifest 历史读取仍由其 Node 调用方分别拥有,此工作流采用不会声明它们。
要从其他工作流使用独立 action,请将 openclaw/openclaw/.github/actions/git-owner@<full-40-character-commit-SHA> 固定到包含该 action 的已审查修订版本。策略应从受信任的工作流内联提供,或从同一受信任 action 包提供,绝不能从选中的候选项提供。在 ci.yml 中,现有的 bundled-protocol 和 CI-routing 矩阵任务会在 Node 设置之前,从单独固定的 .ci-harness checkout 对 action 进行冒烟测试,比较其输出和复制的字节,并在无网络访问的情况下运行受其拥有的 git --version。其他工作流的直接 Git 命令在采用它之前仍不在此所有权覆盖范围内。
Security Review 将其两次五分钟 actions/checkout 尝试保留在
不同目录中。成功 checkout 后,它会将选中的受信任脚本
和策略运行时复制到工作区根目录。失败
尝试目录中的锁和迟到写入无法更改重试的文件。两次尝试都保留
事件的受信任默认分支修订版本和稀疏文件选择。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw