From 4e3ff8defc24242f0fcab5b62a065811a646a96a Mon Sep 17 00:00:00 2001 From: agent-bot Date: Tue, 29 Sep 2026 08:42:45 +0000 Subject: [PATCH] docs(ops): U6a single-binary smoke record (first clean-env validation) 33M binary @5d961147: embedded migrations to v78 on a throwaway isolated PG, embedded UI served (200), instance marker+lock, duplicate-start rejected, config check/explain clean-dir pass. RC stays local per the no-Gitea-components directive; publication gated on authorization. --- .../ops/2026-09-29-u6a-single-binary-smoke.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 .doc/ops/2026-09-29-u6a-single-binary-smoke.md diff --git a/.doc/ops/2026-09-29-u6a-single-binary-smoke.md b/.doc/ops/2026-09-29-u6a-single-binary-smoke.md new file mode 100644 index 00000000..0393ed85 --- /dev/null +++ b/.doc/ops/2026-09-29-u6a-single-binary-smoke.md @@ -0,0 +1,41 @@ +--- +title: "U6a 单文件内部 RC 冒烟记录（首个干净环境验证）" +date: 2026-09-29 +task_id: multi-repo-design-2026-09-28 +binary: agent-system @ 5d961147（33M，CGO_ENABLED=0，内嵌 web/dist） +--- + +# 结论：U6a 单文件冒烟通过（本地 RC，未发布） + +按 KTD14/V9/V27 部分场景，在**无源码目录**的一次性环境验证： + +| 场景 | 结果 | +|---|---| +| 构建 | build-single-binary.sh：web 构建（67×2 预压缩资产）+ go build，33M | +| `config check`（干净目录） | 通过；DB 目标来自进程 env；秘密仅 `/` | +| `config explain` | instance_id 正确标注 process-env 层 | +| 实例引导 | instance-marker.json（rc-smoke，0600）+ instance.lock 创建 | +| **内嵌迁移** | 一次性隔离 pgvector 库从零迁至 **schema_version 78**（goose 内嵌链，无源码目录） | +| 服务启动 | 监听 :5590，/api/v1/health：database_ready:true、schema_ready:true、task_store_ready:true | +| **内嵌 UI** | GET / 返回 SPA index.html（200）——go:embed dist 生效 | +| 误重复启动 | 第二进程退出码 1：“instance already running (lock held)” | +| 优雅退出 | SIGTERM 后进程退出（drain 逻辑 T20-B7 已在库；本次日志因清理时序未留存，退出行为符合预期） | + +隔离纪律：一次性 PG 容器（5544 端口）用后即删，未触碰真实 dev/test 数据； +冒烟目录与二进制已清理。 + +## U10 基建汇合状态 + +U10a（迁移/提示词/xlsx 内嵌 + config check）、U10b（五层配置栈 + 字段溯源）、 +U10c（实例身份/单启锁/根校验 + systemd 模板）全部就位并被本冒烟整体消费。 +优雅退出/readiness 经核实**既有实现已达标**（drain 窗口对齐 AgentTimeout、 +分量就绪健康端点、先初始化后监听——端口打开即就绪，无需冗余改造）。 + +## 未完成 / 后续 + +- **RC 未发布**：按用户指令组件仓/发布仓暂不关联 Gitea；二进制仅本地验证。 + 发布需建 Agent-System-Releases-Internal（private）并经授权。 +- 完整 V9/V27 验收（业务任务、上传/检索、升级/回退、重复发布冲突）待 + 发布阶段在更完整环境执行。 +- managed-local PG profile、serve/init 子命令分化（KTD16）后续补充。 +- 版本号方案：本次为无 tag 冒烟构建；正式 RC 走 `vX.Y.Z-rc.N` 命名。