package webui // 内核更新的 HTTP 端点(GET 检查 / POST 升级)。 // // ## 三端共享同一底层(架构约束) // // agent 的 kernel_update 工具、本端点、CLI(homed-upgrade)三者共享 // internal/update 的 CheckRelease / Apply —— 三份实现必然漂移,会出现 // "WebUI 说有新版、agent 说没有"的分裂状态。 // 本文件只做 HTTP 形状转换,不含业务逻辑。 // // ## 包来源二选一 // // {"release": true} → 从仓库最新 GitHub Release 自动下载 // {"pkg": "/path/to/pkg.tar.gz"} → 用本机已有的安装包(优先) // // ## 升级 = 换产物 + 重启,两件事**分开做** // // Apply(本进程内,同步) :校验 → 备份 → pending → 原子替换 // 重启(交给内核控制通道) :kernelCtl.RequestKernelRestart → exit 42 // → guard 用新二进制重拉(不计失败轮次) // // ★ 为什么 Apply 必须同步返回:替换是**可失败**的动作(空间不足、权限、 // 包损坏)。异步的话这些错误全被吞掉,用户只看到"已受理"然后毫无变化。 // 而重启可以异步 —— 它让本进程消失,本来就没法回给它结果。 // // ★ 为什么不用 systemctl restart:见 cmd/homed/kernel_control.go —— // worker 是被守护方,只有 guard 知道这次退出该不该重拉。 import ( "encoding/json" "log" "net/http" "os" "github.com/JianFeeeee/HologramAgent/internal/events" "github.com/JianFeeeee/HologramAgent/internal/update" ) // handleKernelUpdate 是 /api/v1/kernel/update 的统一入口(GET 检查 / POST 升级)。 func (h *Handler) handleKernelUpdate(w http.ResponseWriter, r *http.Request) { switch r.Method { case http.MethodGet: h.handleKernelUpdateCheck(w, r) case http.MethodPost: h.handleKernelUpdateApply(w, r) default: writeJSONError(w, http.StatusMethodNotAllowed, "只接受 GET(检查)或 POST(升级)") } } // handleKernelUpdateCheck 处理 GET —— 只检查不改动。 func (h *Handler) handleKernelUpdateCheck(w http.ResponseWriter, r *http.Request) { writeJSON(w, http.StatusOK, update.CheckRelease(currentKernelVersion())) } // handleKernelUpdateApply 处理 POST /api/v1/kernel/update —— 执行升级。 func (h *Handler) handleKernelUpdateApply(w http.ResponseWriter, r *http.Request) { var body struct { Pkg string `json:"pkg"` Release bool `json:"release"` } // body 可为空(不合法就在下面报"必须指定来源"),所以解码失败不单独报错。 _ = json.NewDecoder(r.Body).Decode(&body) src, err := update.ParseSource(body.Pkg, body.Release) if err != nil { writeJSONError(w, http.StatusBadRequest, err.Error()) return } binPath := update.KernelBinaryPath() tmp, err := os.MkdirTemp("", "kernel-upgrade-*") if err != nil { writeJSONError(w, http.StatusInternalServerError, "建临时目录失败: "+err.Error()) return } defer os.RemoveAll(tmp) root, rel, err := src.Resolve(tmp) if err != nil { writeJSONError(w, http.StatusBadGateway, "取包失败: "+err.Error()) return } newDG := update.FindFile(root, "depgraph.bin") // WebUI 侧天然有总线(它就是 SSE 的上游):升级每一步都让界面看得到 var bus *events.Bus if h.sdk != nil { bus = h.sdk.EventBus() } out, err := update.Apply(root, binPath, newDG, dataDirOf(binPath), bus) if err != nil { writeJSONError(w, http.StatusInternalServerError, err.Error()) return } res := map[string]interface{}{ "applied": true, "from": out.From.Version, "to": out.To.Version, "backup": out.BackupDir, "message": "新内核已就位,正在重启。新版本启动后由第 0 层 update 模块确认;无法启动会自动回滚。", } if rel != nil { res["release"] = rel.Latest res["asset"] = rel.Asset } // 先把响应写回,再让内核消失(同 kernel/restart 的教训:不 Flush 会 // 变成 connection reset,用户以为出错了)。 writeJSON(w, http.StatusOK, res) if f, ok := w.(http.Flusher); ok { f.Flush() } // 重启走**既有**内核控制通道(restartCh → exit 42 → guard 用新二进制重拉)。 // 不自己 systemctl,也不另开通道。 if h.kernelCtl == nil { log.Printf("[webui] 新内核已就位,但内核控制通道不可用(kernelControlAllowed 未授予 webui),无法请求重启") return } if err := h.kernelCtl.RequestKernelRestart("kernel_update apply"); err != nil { log.Printf("[webui] kernel restart request failed (新内核已就位,需手动重启): %v", err) } } // currentKernelVersion 读本机 homed 的版本(尽力而为)。 func currentKernelVersion() *update.BinVersion { bin := update.KernelBinaryPath() if _, err := os.Stat(bin); err != nil { return nil } v, err := update.ReadBinVersion(bin) if err != nil { return nil } return v } // dataDirOf 返回内核**真实**的数据目录(ks.DataDir,来自 `-data`)。 // // ★ 取注入值,不做任何推导:pending 标记落在哪,第 0 层 update 模块就从 // 哪读;两边一漂移,升级失败时就**静默不回滚**。而“猜一个看起来合理的 // 路径”(曾用过 env → exe 同级 data)会让 Apply 的空值守卫变成死代码—— // 实测生产是 `--data /var/lib/hologram`,而 exe 推导得 /usr/bin/data // (只读目录,建备份必 EROFS)。 // // 拿不到就返回空串,由 Apply 拒绝升级并报错。 func dataDirOf(binPath string) string { return update.KernelDataDir() }