mirror of
https://github.com/getcompanion-ai/computer-host.git
synced 2026-04-15 06:04:38 +00:00
* feat: add Firecracker API client methods for VM pause/resume and snapshots
Add PatchVm, GetVm, PutSnapshotCreate, and PutSnapshotLoad methods to the
API client, along with supporting types (VmState, SnapshotCreateParams,
SnapshotLoadParams, MemBackend).
* feat: add snapshot data layer - contract types, model, store, config
Add SnapshotID and snapshot contract types, SnapshotRecord model,
store interface CRUD methods with file store implementation,
snapshot paths helper, SnapshotsDir config, and directory creation.
* feat: add runtime methods for VM pause, resume, snapshot, and restore
Implement Pause, Resume, CreateSnapshot, and RestoreBoot on the
firecracker Runtime. RestoreBoot launches a jailer, stages snapshot
files into the chroot, loads the snapshot, and resumes the VM.
* feat: add daemon snapshot create, restore, and reconciliation logic
Implement CreateSnapshot (pause, snapshot, COW-copy disk, resume),
RestoreSnapshot (COW-copy disk, RestoreBoot, wait for guest),
GetSnapshot, ListSnapshots, DeleteSnapshotByID, and crash recovery
reconciliation for snapshot and restore operations.
* feat: add HTTP endpoints for snapshot create, get, list, delete, restore
Wire 5 snapshot routes: POST /machines/{id}/snapshots (create),
GET /machines/{id}/snapshots (list), GET /snapshots/{id} (get),
DELETE /snapshots/{id} (delete), POST /snapshots/{id}/restore (restore).
* fix: cross-device rename, restore network, and snapshot cleanup
- Replace os.Rename with copy+remove for moving snapshot files out of
/proc/<pid>/root/ (cross-device link error on Linux)
- Reconfigure network interface after snapshot load so the restored VM
uses its own tap device instead of the source VM's
- Clean partial snapshot dirs immediately on failure instead of only
via reconcile
- Reject snapshot requests while a machine operation is already pending
* fix: test and modify snapshot runtime
* feat: snapshot lifecycle update, align runtime issues between host image
and daemon
230 lines
6.4 KiB
Go
230 lines
6.4 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"net/http"
|
|
"strings"
|
|
|
|
contracthost "github.com/getcompanion-ai/computer-host/contract"
|
|
)
|
|
|
|
type Service interface {
|
|
CreateMachine(context.Context, contracthost.CreateMachineRequest) (*contracthost.CreateMachineResponse, error)
|
|
GetMachine(context.Context, contracthost.MachineID) (*contracthost.GetMachineResponse, error)
|
|
ListMachines(context.Context) (*contracthost.ListMachinesResponse, error)
|
|
StopMachine(context.Context, contracthost.MachineID) error
|
|
DeleteMachine(context.Context, contracthost.MachineID) error
|
|
Health(context.Context) (*contracthost.HealthResponse, error)
|
|
CreateSnapshot(context.Context, contracthost.MachineID) (*contracthost.CreateSnapshotResponse, error)
|
|
ListSnapshots(context.Context, contracthost.MachineID) (*contracthost.ListSnapshotsResponse, error)
|
|
GetSnapshot(context.Context, contracthost.SnapshotID) (*contracthost.GetSnapshotResponse, error)
|
|
DeleteSnapshotByID(context.Context, contracthost.SnapshotID) error
|
|
RestoreSnapshot(context.Context, contracthost.SnapshotID, contracthost.RestoreSnapshotRequest) (*contracthost.RestoreSnapshotResponse, error)
|
|
}
|
|
|
|
type Handler struct {
|
|
service Service
|
|
}
|
|
|
|
func New(service Service) (*Handler, error) {
|
|
if service == nil {
|
|
return nil, fmt.Errorf("service is required")
|
|
}
|
|
return &Handler{service: service}, nil
|
|
}
|
|
|
|
func (h *Handler) Routes() http.Handler {
|
|
mux := http.NewServeMux()
|
|
mux.HandleFunc("/health", h.handleHealth)
|
|
mux.HandleFunc("/machines", h.handleMachines)
|
|
mux.HandleFunc("/machines/", h.handleMachine)
|
|
mux.HandleFunc("/snapshots/", h.handleSnapshot)
|
|
return mux
|
|
}
|
|
|
|
func (h *Handler) handleHealth(w http.ResponseWriter, r *http.Request) {
|
|
if r.Method != http.MethodGet {
|
|
writeMethodNotAllowed(w)
|
|
return
|
|
}
|
|
response, err := h.service.Health(r.Context())
|
|
if err != nil {
|
|
writeError(w, http.StatusInternalServerError, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response)
|
|
}
|
|
|
|
func (h *Handler) handleMachines(w http.ResponseWriter, r *http.Request) {
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
response, err := h.service.ListMachines(r.Context())
|
|
if err != nil {
|
|
writeError(w, http.StatusInternalServerError, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response)
|
|
case http.MethodPost:
|
|
var request contracthost.CreateMachineRequest
|
|
if err := json.NewDecoder(r.Body).Decode(&request); err != nil {
|
|
writeError(w, http.StatusBadRequest, err)
|
|
return
|
|
}
|
|
response, err := h.service.CreateMachine(r.Context(), request)
|
|
if err != nil {
|
|
writeError(w, http.StatusBadRequest, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusCreated, response)
|
|
default:
|
|
writeMethodNotAllowed(w)
|
|
}
|
|
}
|
|
|
|
func (h *Handler) handleMachine(w http.ResponseWriter, r *http.Request) {
|
|
path := strings.TrimPrefix(r.URL.Path, "/machines/")
|
|
if path == "" {
|
|
writeError(w, http.StatusNotFound, fmt.Errorf("machine id is required"))
|
|
return
|
|
}
|
|
parts := strings.Split(path, "/")
|
|
machineID := contracthost.MachineID(parts[0])
|
|
|
|
if len(parts) == 1 {
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
response, err := h.service.GetMachine(r.Context(), machineID)
|
|
if err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response)
|
|
case http.MethodDelete:
|
|
if err := h.service.DeleteMachine(r.Context(), machineID); err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
w.WriteHeader(http.StatusNoContent)
|
|
default:
|
|
writeMethodNotAllowed(w)
|
|
}
|
|
return
|
|
}
|
|
|
|
if len(parts) == 2 && parts[1] == "stop" {
|
|
if r.Method != http.MethodPost {
|
|
writeMethodNotAllowed(w)
|
|
return
|
|
}
|
|
if err := h.service.StopMachine(r.Context(), machineID); err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
w.WriteHeader(http.StatusNoContent)
|
|
return
|
|
}
|
|
|
|
if len(parts) == 2 && parts[1] == "snapshots" {
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
response, err := h.service.ListSnapshots(r.Context(), machineID)
|
|
if err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response)
|
|
case http.MethodPost:
|
|
response, err := h.service.CreateSnapshot(r.Context(), machineID)
|
|
if err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusCreated, response)
|
|
default:
|
|
writeMethodNotAllowed(w)
|
|
}
|
|
return
|
|
}
|
|
|
|
writeError(w, http.StatusNotFound, fmt.Errorf("route not found"))
|
|
}
|
|
|
|
func (h *Handler) handleSnapshot(w http.ResponseWriter, r *http.Request) {
|
|
path := strings.TrimPrefix(r.URL.Path, "/snapshots/")
|
|
if path == "" {
|
|
writeError(w, http.StatusNotFound, fmt.Errorf("snapshot id is required"))
|
|
return
|
|
}
|
|
parts := strings.Split(path, "/")
|
|
snapshotID := contracthost.SnapshotID(parts[0])
|
|
|
|
if len(parts) == 1 {
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
response, err := h.service.GetSnapshot(r.Context(), snapshotID)
|
|
if err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response)
|
|
case http.MethodDelete:
|
|
if err := h.service.DeleteSnapshotByID(r.Context(), snapshotID); err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
w.WriteHeader(http.StatusNoContent)
|
|
default:
|
|
writeMethodNotAllowed(w)
|
|
}
|
|
return
|
|
}
|
|
|
|
if len(parts) == 2 && parts[1] == "restore" {
|
|
if r.Method != http.MethodPost {
|
|
writeMethodNotAllowed(w)
|
|
return
|
|
}
|
|
var req contracthost.RestoreSnapshotRequest
|
|
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
|
|
writeError(w, http.StatusBadRequest, err)
|
|
return
|
|
}
|
|
response, err := h.service.RestoreSnapshot(r.Context(), snapshotID, req)
|
|
if err != nil {
|
|
writeError(w, statusForError(err), err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusCreated, response)
|
|
return
|
|
}
|
|
|
|
writeError(w, http.StatusNotFound, fmt.Errorf("route not found"))
|
|
}
|
|
|
|
func statusForError(err error) int {
|
|
message := strings.ToLower(err.Error())
|
|
switch {
|
|
case strings.Contains(message, "not found"):
|
|
return http.StatusNotFound
|
|
case strings.Contains(message, "already exists"):
|
|
return http.StatusConflict
|
|
default:
|
|
return http.StatusBadRequest
|
|
}
|
|
}
|
|
|
|
func writeError(w http.ResponseWriter, status int, err error) {
|
|
writeJSON(w, status, map[string]string{"error": err.Error()})
|
|
}
|
|
|
|
func writeJSON(w http.ResponseWriter, status int, value any) {
|
|
w.Header().Set("Content-Type", "application/json")
|
|
w.WriteHeader(status)
|
|
_ = json.NewEncoder(w).Encode(value)
|
|
}
|
|
|
|
func writeMethodNotAllowed(w http.ResponseWriter) {
|
|
writeError(w, http.StatusMethodNotAllowed, fmt.Errorf("method not allowed"))
|
|
}
|