Kørsel og verifikation

Kør den self-hostede VM-konsol som en privilegeret del af KVM-værten. Container-sundhed alene er ikke nok: verificér stien fra browser til API til libvirt til gæsten.

Startkontrol


docker compose -f docker-compose.self-hosted.yml ps
docker compose -f docker-compose.self-hosted.yml logs --tail=200 backend frontend
virsh -c qemu:///system list --all

Bekræft derefter, at UI indlæses, og at backend mode-svaret rapporterer self-hosted mode. Gennemgå feature map i stedet for at antage, at en hostet funktion findes.

End-to-end røgtest

Brug et engangs-, licenseret test-ISO:

upload ISO’en og verificér vist størrelse og navn;
opret en lille VM med eksplicitte valg for CPU, hukommelse, disk og netværk;
start den, og åbn VNC-konsollen;
bekræft, at boot-fremgang er synlig, og at tastaturinput når gæsten;
stop VM’en;
slet den, og bekræft, at domain, overlays og midlertidig NVRAM ryddes op;
genstart backend, og bekræft, at ingen stale replacement launch forbliver blokeret.

Fortolk ikke en vellykket boot som hardwarecertificering, applikationskorrekthed, patch-overholdelse eller bevis for, at en installer afsluttede.

Operationelle signaler

Overvåg mindst:

frontend- og API-tilgængelighed;
backend-libvirt-forbindelse;
ledig værthukommelse og diskplads;
mislykkede uploads og guest-launch-fejl;
gæstedomæner, overlays, NVRAM og netværksinventar;
persistent cleanup journal under TEST_STORAGE_DIR;
container-genstartsløkker og backend-undtagelser.

Evaluerings-Compose-filen konfigurerer ikke et eksternt alertsystem.

Almindelige fejl

Symptom	Tjek
`/dev/kvm` permission denied	Værtsgruppemedlemskab og enhedsmapping; gør ikke enheden world-writable
Kan ikke forbinde til libvirt	Daemonstatus, socket-sti, `KVM_URI` og container mount
Upload afvist	Filtype, ledig plads, rettigheder til image-bibliotek og konfigureret size limit
Gæst kan ikke åbne source image	Absolute-path identity vært/container og read permission
VNC afbryder	Gæsttilstand, libvirt graphics endpoint, proxy-sti og browser console diagnostics
Replacement launch stadig blokeret	Persisted cleanup journal, stale domain/overlay/NVRAM-ressourcer og backend-logfiler

Nedlukning

Stop eller slet engangsgæster i UI, før du stopper stacken. Kør derefter:


docker compose -f docker-compose.self-hosted.yml down

Tag efterfølgende inventar over libvirt-domæner, images, netværk og named volume. At stoppe containere fjerner ikke automatisk hver værts-ejet ressource.