Skip to content

Commit 5cfebb0

Browse files
committed
docs(sidecar): add bilingual LFS exhaustion runbook
1 parent 5bd6712 commit 5cfebb0

2 files changed

Lines changed: 80 additions & 0 deletions

File tree

docs/en/sidecar_supply_strategy.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,46 @@ Important boundary:
207207

208208
- switch from legacy-allowlist verification toward strict no-LFS enforcement for protected roots
209209

210+
### Operational playbook when monthly LFS bandwidth is exhausted (2026-04-09)
211+
212+
When local checkout/pull fails due to Git LFS bandwidth exhaustion, use this fallback path:
213+
214+
1. Skip LFS smudge for branch switch and sync:
215+
216+
```bash
217+
GIT_LFS_SKIP_SMUDGE=1 git checkout main
218+
GIT_LFS_SKIP_SMUDGE=1 git pull --ff-only origin main
219+
```
220+
221+
2. Verify that no new protected LFS drift was introduced:
222+
223+
```bash
224+
npm run verify:lfs:policy
225+
```
226+
227+
3. Verify sidecar supply readiness and current network dependency status:
228+
229+
```bash
230+
npm run verify:sidecar:supply -- --json
231+
```
232+
233+
4. Serve docs locally for ops visibility and review:
234+
235+
```bash
236+
npm run docs:site:serve -- -a 127.0.0.1:8013
237+
```
238+
239+
5. Keep CI design stable. Do not redesign default release CI for this emergency flow; use the existing mirror-first release workflow and only use `allow_godot_upstream_fallback=false` through `workflow_dispatch` for mirror-only smoke verification.
240+
241+
Execution note validated on 2026-04-09:
242+
243+
- PR #1 was merged to `main` and all triggered `main` workflows completed successfully:
244+
- Migration Gates
245+
- Mobile E2E Detox Contracts
246+
- Fixrisk Operational Readiness
247+
- Docs Diataxis Site
248+
- Docs GitHub Pages Publish
249+
210250
### Bottom line
211251

212252
The correct question is not:

docs/zh/sidecar_supply_strategy.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,46 @@ npm run verify:sidecar:supply -- --json
207207

208208
- 从“允许历史豁免”的校验,切换到对受保护目录执行严格 no-LFS
209209

210+
### 月度 LFS 带宽超量时的运行手册(2026-04-09)
211+
212+
当本地 checkout/pull 因 Git LFS 带宽超量失败时,按以下应急路径执行:
213+
214+
1. 在切分支与同步阶段跳过 LFS smudge:
215+
216+
```bash
217+
GIT_LFS_SKIP_SMUDGE=1 git checkout main
218+
GIT_LFS_SKIP_SMUDGE=1 git pull --ff-only origin main
219+
```
220+
221+
2. 先确认没有新增受保护 LFS 回流:
222+
223+
```bash
224+
npm run verify:lfs:policy
225+
```
226+
227+
3. 再确认 sidecar 供给就绪度与网络依赖现状:
228+
229+
```bash
230+
npm run verify:sidecar:supply -- --json
231+
```
232+
233+
4. 启动本地文档站点用于运维可视化与复核:
234+
235+
```bash
236+
npm run docs:site:serve -- -a 127.0.0.1:8013
237+
```
238+
239+
5. 保持 CI 设计稳定:这个应急流程不要求重构默认 release CI;继续沿用现有 mirror-first 工作流,仅在 `workflow_dispatch` 下通过 `allow_godot_upstream_fallback=false` 做 mirror-only smoke 校验。
240+
241+
2026-04-09 已验证执行记录:
242+
243+
- PR #1 已合并到 `main`,并且该提交触发的 `main` 工作流全部成功:
244+
- Migration Gates
245+
- Mobile E2E Detox Contracts
246+
- Fixrisk Operational Readiness
247+
- Docs Diataxis Site
248+
- Docs GitHub Pages Publish
249+
210250
### 结论
211251

212252
真正该问的问题不是:

0 commit comments

Comments
 (0)