From 95093e7bce5c5fe41d34f17fa7cc4da70394ef5e Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 1 May 2026 12:42:21 +0800 Subject: [PATCH] docs: close phase 7.3 capacity governance --- project-docs/运维手册-2026-05-01.md | 8 +- .../闭环交付与深度开发方案-2026-05-01.md | 4 +- ...容量治理与备份保留策略执行记录-2026-05-01.md | 79 ++++++++++++++++++- ...7.3-容量治理与备份保留策略方案-2026-05-01.md | 2 + 4 files changed, 86 insertions(+), 7 deletions(-) diff --git a/project-docs/运维手册-2026-05-01.md b/project-docs/运维手册-2026-05-01.md index b37e1896..73650cea 100644 --- a/project-docs/运维手册-2026-05-01.md +++ b/project-docs/运维手册-2026-05-01.md @@ -267,7 +267,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-production-o 该脚本会检查 Docker 服务状态、远端磁盘使用率、frontend 发布备份、后端健康端点、readiness 和前端首页。 -当前容量基线：阶段 7.2 巡检显示服务器磁盘约 `87%-88%`，已触发 WARN。若继续增长到 `90%`，巡检门禁将转为 FAIL；应优先清理过期备份、Docker build cache 和未使用镜像。 +当前容量基线：阶段 7.3 清理后服务器磁盘约 `67%`，已低于 `80%` WARN 阈值。若重新增长到 `80%`，巡检门禁将转为 WARN；若增长到 `90%`，巡检门禁将转为 FAIL。 容量治理 dry run： @@ -288,6 +288,12 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-capacity-gov 3. 回滚备份保留最近 `10` 个，并且只删除超过 `14` 天的旧文件。 4. Docker 清理只处理 builder cache 和 dangling images，不执行 `docker system prune -a`，不删除 volumes。 +若常规 `-Apply` 后磁盘仍超过 `80%`，可执行强化 builder cache 清理： + +```powershell +powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-capacity-governance.ps1 -Apply -SkipBackupCleanup -DockerBuilderPruneUntilHours 0 +``` + 列出可回滚的 frontend 备份： ```powershell diff --git a/project-docs/闭环交付与深度开发方案-2026-05-01.md b/project-docs/闭环交付与深度开发方案-2026-05-01.md index 67ba8868..f49b457f 100644 --- a/project-docs/闭环交付与深度开发方案-2026-05-01.md +++ b/project-docs/闭环交付与深度开发方案-2026-05-01.md @@ -20,7 +20,7 @@ 阶段 1 已完成源码闭环与生产入口闭环，生产无人 E2E `18/18` 通过。阶段 2 已完成 Review 重试、Knowledge Base 文档重试、Review -> Chat -> Contract 上下文联动、首页交付工作台和阶段 2 自动化无人闭环，本地与生产 E2E 均 `7/7` 通过。阶段 3 已完成系统 readiness、试点交付准备页、默认账号说明、演示样本数据、依赖健康门禁和阶段 3 自动化无人闭环，本地与生产 E2E 均 `5/5` 通过。 -当前后续重点已从“生产运营自动化与发布门禁固化”推进到“生产运营常态化与一键发布”：阶段 7 首批一键发布闭环已完成，阶段 7.2 一键回滚与生产巡检门禁也已完成首批闭环。当前正在进入阶段 7.3 容量治理：固化备份保留策略、Docker build cache/旧镜像清理和磁盘告警阈值。 +当前后续重点已从“生产运营自动化与发布门禁固化”推进到“生产运营常态化与一键发布”：阶段 7 首批一键发布闭环已完成，阶段 7.2 一键回滚与生产巡检门禁也已完成首批闭环。阶段 7.3 容量治理已完成，备份保留策略、Docker build cache/旧镜像清理和磁盘告警阈值已固化；服务器磁盘从 `89%` 降至 `67%`。 --- @@ -220,4 +220,4 @@ AI合同平台当前已经不是从零建设阶段。登录、合同审查、Rev ## 六、当前一句话结论 -AI合同平台阶段 1、阶段 2、阶段 3、阶段 4、阶段 5、阶段 6、阶段 7 和阶段 7.2 均已完成闭环交付验证。当前系统具备主业务闭环、试点交付准备、生产健康巡检、备份恢复演练、依赖治理、安全基线、生产关键 E2E 回归、前端视觉刷新验收、统一发布门禁证据、Docker 一键发布和一键回滚证据。当前持续风险为服务器磁盘容量 WARN。 +AI合同平台阶段 1、阶段 2、阶段 3、阶段 4、阶段 5、阶段 6、阶段 7、阶段 7.2 和阶段 7.3 均已完成闭环交付验证。当前系统具备主业务闭环、试点交付准备、生产健康巡检、备份恢复演练、依赖治理、安全基线、生产关键 E2E 回归、前端视觉刷新验收、统一发布门禁证据、Docker 一键发布、一键回滚和容量治理证据。阶段 7.3 已解除服务器磁盘容量 WARN。 diff --git a/project-docs/阶段7.3-容量治理与备份保留策略执行记录-2026-05-01.md b/project-docs/阶段7.3-容量治理与备份保留策略执行记录-2026-05-01.md index 4348f176..e9841acf 100644 --- a/project-docs/阶段7.3-容量治理与备份保留策略执行记录-2026-05-01.md +++ b/project-docs/阶段7.3-容量治理与备份保留策略执行记录-2026-05-01.md @@ -13,9 +13,9 @@ | 容量治理脚本 | READY | 已新增 `scripts/run-capacity-governance.ps1` | | 初始容量状态 | WARN | 远端 `/` 磁盘 `88%` | | dry run | PASS_WITH_CAPACITY_WARN | 策略计算通过，备份无删除候选，Docker 可回收空间明显 | -| 正式清理 | PENDING | 待执行 | -| 清理后巡检 | PENDING | 待执行 | -| 清理后 release gate | PENDING | 待执行 | +| 正式清理 | PASS | Docker build cache 和 dangling images 清理完成，备份未删除 | +| 清理后巡检 | PASS | 磁盘使用率降至 `67%`，ops check PASS | +| 清理后 release gate | PASS | strict release gate PASS | --- @@ -65,8 +65,79 @@ project-docs/qa-artifacts/phase7-capacity-governance/2026-05-01T12-34-41-578/ ## 四、待执行验证 -正式清理将在脚本提交后、干净工作区中执行： +## 四、正式清理结果 + +### 第一轮正式清理 + +验证命令： ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-capacity-governance.ps1 -Apply ``` + +验证产物： + +```text +project-docs/qa-artifacts/phase7-capacity-governance/2026-05-01T12-36-00-982/ +``` + +结论： + +1. backup retention PASS，发布备份删除 `0`，回滚备份删除 `0`。 +2. Docker prune PASS。 +3. 磁盘从 `89%` 降至 `87%`，仍超过 `80%` WARN 阈值。 +4. 第一轮策略只清理 `24h` 以前的 builder cache，仍保留大量较新的 build cache。 + +### 强化 builder cache 清理 + +验证命令： + +```powershell +powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-capacity-governance.ps1 -Apply -SkipBackupCleanup -DockerBuilderPruneUntilHours 0 -ArtifactRoot project-docs\qa-artifacts\phase7-capacity-governance-aggressive-builder-prune +``` + +验证产物： + +```text +project-docs/qa-artifacts/phase7-capacity-governance-aggressive-builder-prune/2026-05-01T12-36-53-184/ +``` + +结论： + +1. backup retention SKIP，本轮不删除备份。 +2. Docker prune PASS。 +3. Build Cache 从 `24.27GB` 降至 `0B`。 +4. 磁盘从 `87%` 降至 `67%`，容量 WARN 解除。 + +--- + +## 五、清理后验证 + +生产巡检门禁： + +```text +project-docs/qa-artifacts/phase7.3-final-ops-check/2026-05-01T12-39-13-706/ +``` + +结论： + +1. Docker services PASS。 +2. Remote disk usage PASS：`67%`。 +3. Frontend backups PASS：发布备份 `2` 个。 +4. Backend health PASS。 +5. System readiness PASS。 +6. Frontend home PASS。 + +最终 release gate： + +```text +project-docs/qa-artifacts/phase7.3-final-release-gate/2026-05-01T12-39-23/ +``` + +结论：PASS。 + +--- + +## 六、阶段结论 + +阶段 7.3 容量治理闭环 PASS：磁盘容量从 `89%` 降至 `67%`，Docker build cache 已清理到 `0B`，备份保留策略已固化且本次未删除任何 frontend 备份，清理后生产巡检和 release gate 均 PASS。 diff --git a/project-docs/阶段7.3-容量治理与备份保留策略方案-2026-05-01.md b/project-docs/阶段7.3-容量治理与备份保留策略方案-2026-05-01.md index 43978f4b..96fc946e 100644 --- a/project-docs/阶段7.3-容量治理与备份保留策略方案-2026-05-01.md +++ b/project-docs/阶段7.3-容量治理与备份保留策略方案-2026-05-01.md @@ -88,3 +88,5 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-capacity-gov 4. 执行后生产巡检 required 项 PASS。 5. 执行后 release gate PASS。 6. 若磁盘仍高于 `80%`，必须保留 WARN 结论和下一步容量治理建议。 + +当前闭环状态：PASS。阶段 7.3 已通过 dry run、正式清理、强化 builder cache 清理、生产巡检和 release gate；磁盘使用率从 `89%` 降至 `67%`。