Drift och verifiering

Kör den self-hostade VM-konsolen som en privilegierad del av KVM-värden. Containerhälsa räcker inte: verifiera vägen från webbläsare till API till libvirt till gästen.

Startkontroll


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äfta sedan att UI laddas och att backend mode-svaret rapporterar self-hosted mode. Granska feature map i stället för att anta att en hostad funktion finns.

End-to-end röktest

Använd en engångs-, licensierad test-ISO:

ladda upp ISO:n och verifiera visad storlek och namn;
skapa en liten VM med explicita val för CPU, minne, disk och nätverk;
starta den och öppna VNC-konsolen;
bekräfta att boot-förlopp syns och att tangentbordsinmatning når gästen;
stoppa VM:en;
ta bort den och bekräfta att domain, overlays och tillfällig NVRAM städas bort;
starta om backend och bekräfta att ingen stale replacement launch blockeras kvar.

Tolka inte en lyckad boot som hårdvarucertifiering, applikationskorrekthet, patch-efterlevnad eller bevis på att en installerare slutfördes.

Operativa signaler

Övervaka minst:

frontend- och API-nåbarhet;
backend-libvirt-anslutning;
ledigt värdminne och diskutrymme;
misslyckade uppladdningar och guest-launch-fel;
gästdomäner, overlays, NVRAM och nätverksinventering;
persistent cleanup journal under TEST_STORAGE_DIR;
container-omstartsloopar och backend-undantag.

Utvärderingsfilen Compose konfigurerar inget externt larm.

Vanliga fel

Symptom	Kontrollera
`/dev/kvm` permission denied	Värdgruppsmedlemskap och enhetsmappning; gör inte enheten world-writable
Kan inte ansluta till libvirt	Daemonstatus, socket-sökväg, `KVM_URI` och container mount
Uppladdning avvisad	Filtyp, ledigt utrymme, behörigheter för image-katalog och konfigurerad size limit
Gäst kan inte öppna source image	Absolute-path identity värd/container och read permission
VNC kopplar från	Gäststatus, libvirt graphics endpoint, proxy-sökväg och browser console diagnostics
Replacement launch fortsatt blockerad	Persisted cleanup journal, stale domain/overlay/NVRAM-resurser och backend-loggar

Avstängning

Stoppa eller ta bort engångsgäster i UI innan du stoppar stacken. Kör sedan:


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

Inventera libvirt-domäner, images, nätverk och named volume efteråt. Att stoppa containrar tar inte automatiskt bort varje värdägd resurs.