pikasTech-HWLAB/docs/reference/node-gitops-cicd.md

Node GitOps CI/CD（历史路径）

本文不再承载 node/lane CI/CD、GitOps 或公开入口需求规格正文。

统一规格出处是 UniDesk OA：

• PJ2026-0106 平台运维
• PJ2026-010601 发布流水
• PJ2026-010602 源码同步
• PJ2026-010603 YAML运维
• PJ2026-010604 公开入口
• PJ2026-010605 运维监控

目标 node/lane 的具体实现、PipelineRun 观察和运行命令仍按本仓 AGENTS.md 与受控 CLI 执行；需求边界、node/lane 规则和运维职责只更新 UniDesk OA。

运行参考

node/lane rollout 的 120 秒阈值是性能告警和诊断分界，不是继续盲等的理由。trigger-current --wait 超过阈值或返回 pending 时，先用定点 hwlab nodes control-plane status --node <node> --lane <lane> --pipeline-run <name>、git-mirror status 和 runtime workload 摘要确认卡在哪一层：PipelineRun task、Argo sync、runtime-ready、public probe 或 git mirror flush。

只需要给 branch-follower 或 control-plane closeout 提供一轮新的真实验证源时，优先使用文档、注释或等价的非运行面小 PR，避免把 timeout、runtime 策略或 CI/CD 逻辑改动混入验证样本。

PR 合并后如果目标分支被并行 PR 推进，closeout 要同时记录本 PR merge commit、当前 source head 和 ancestry 证据；只要当前 head 包含本 PR merge commit，后续 rollout 应按当前 head 收敛，避免回滚到旧 source。定点 status 可证明某个旧 PipelineRun 是否 succeeded，但最终用户入口验收必须以当前 node/lane source、GitOps revision、Argo 和 runtime 状态为准。

runtime-ready 卡住时先看 STATUS 输出里的 notReady workload，再按 workload 日志和事件定位；修复应回到 source truth、PR、GitOps 和受控 sync/refresh，不把手工 patch Deployment、裸删 Pod 或临时容器改动作为交付路径。若 runtime 已 ready 但 Argo 仍 OutOfSync/Progressing，先走受控 hwlab nodes control-plane sync|refresh --node <node> --lane <lane> --confirm 收敛控制面，再复查 bounded status。