docs(ops): U6a single-binary smoke record (first clean-env validation)
CI / go-vet (pull_request) Successful in 12s
CI / short-tests-report (pull_request) Failing after 35s
CI / backup-restore-drill (pull_request) Successful in 26s
CI / web (pull_request) Successful in 32s

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.
This commit is contained in:
2026-09-29 08:42:45 +00:00
parent 5d96114777
commit 4e3ff8defc
@@ -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;秘密仅 `<set>/<unset>` |
| `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` 命名。