Communitygithub.com

AGLz/agl-hostman

Machines virtuelles QEMU/KVM AGL

Qu'est-ce que agl-hostman ?

Cette compétence permet de gérer des machines virtuelles QEMU/KVM sur un hôte Proxmox nommé AGLSRV1, utilisées dans le cadre d'un environnement AGL (Automotive Grade Linux). Elle inclut les opérations de base comme le démarrage, l'arrêt, le redémarrage et le clonage de VMs via les commandes `qm`, ainsi que la gestion des snapshots, des disques et de la configuration des ressources (mémoire, CPU, réseau). Un accent particulier est mis sur la VM AGLWK45 (VMID 104) qui exécute le service OpenClaw Gateway, avec des vérifications d'état via l'agent invité QEMU et Tailscale. La compétence couvre également l'installation et l'utilisation du QEMU Guest Agent pour exécuter des commandes à distance, geler le système de fichiers avant snapshot, et résoudre les problèmes courants (démarrage, réseau, agent invité).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Machines virtuelles QEMU/KVM AGL

VMs QEMU AGL

VMIDHôteNomRôleAdresse Tailscale
104AGLSRV1aglwk45Worker OpenClaw (Windows)Via 192.168.0.245

Accès

# AGLSRV1 (hôte Proxmox avec QEMU/KVM)
ssh AGLSRV1  # 192.168.0.245 (LAN) ou 100.107.113.33 (Tailscale)

Opérations VMs QEMU (via qm)

Lister toutes les VMs

ssh AGLSRV1 "qm list"

Démarrer/Arrêter une VM

# Démarrer
ssh AGLSRV1 "qm start 104"

# Arrêter (extinction ACPI)
ssh AGLSRV1 "qm shutdown 104"

# Arrêter forcé
ssh AGLSRV1 "qm stop 104"

# Redémarrer
ssh AGLSRV1 "qm reboot 104"

État de la VM

ssh AGLSRV1 "qm status 104"
ssh AGLSRV1 "qm list | grep 104"

Accès console

# Console VNC (obtenir le port VNC)
ssh AGLSRV1 "qm vncproxy 104"

# Console série (si configurée)
ssh AGLSRV1 "qm terminal 104"

Snapshots

# Créer un snapshot
ssh AGLSRV1 "qm snapshot 104 pre-update"

# Lister les snapshots
ssh AGLSRV1 "qm listsnapshot 104"

# Restaurer (la VM doit être arrêtée)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

# Supprimer un snapshot
ssh AGLSRV1 "qm delsnapshot 104 pre-update"

Cloner une VM

# Clone complet
ssh AGLSRV1 "qm clone 104 <nouvel-vmid> --name <nouveau-nom> --full"

# Clone lié (plus rapide, dépend de la source)
ssh AGLSRV1 "qm clone 104 <nouvel-vmid> --name <nouveau-nom>"

Configuration des ressources

# Définir la mémoire
ssh AGLSRV1 "qm set 104 --memory 8192"

# Définir le nombre de cœurs CPU
ssh AGLSRV1 "qm set 104 --cores 4"

# Définir le pont réseau
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"

Agent invité QEMU

Installation (à l'intérieur de la VM)

# Windows
# Installer qemu-ga depuis l'ISO des pilotes VirtIO

# Linux
apt install qemu-guest-agent  # Debian/Ubuntu
systemctl enable qemu-guest-agent
systemctl start qemu-guest-agent

Activer dans Proxmox

ssh AGLSRV1 "qm set 104 --agent enabled=1"

Utilisation de l'agent invité

# Obtenir les infos de la VM via l'agent invité
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# Obtenir les interfaces réseau
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# Exécuter une commande à l'intérieur de la VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"

# Geler le système de fichiers (pour les snapshots)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"

Gestion des disques

Lister les disques

ssh AGLSRV1 "qm config 104 | grep virtio"

Redimensionner un disque

ssh AGLSRV1 "qm resize 104 virtio0 +10G"

Déplacer un disque

# Déplacer vers un autre stockage
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"

Spécifique à AGLWK45 (VM104)

OpenClaw sur AGLWK45

# Vérifier le statut d'OpenClaw via l'agent invité
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"

# Ou via Tailscale depuis l'intérieur de la VM
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

Script de vérification

# Exécuter le script de vérification depuis le dépôt
./scripts/verify-aglwk45-fgsrv06.sh

QEMU Direct (sans Proxmox)

Pour une utilisation autonome de QEMU :

# Démarrer une VM QEMU
qemu-system-x86_64 \
  -enable-kvm \
  -m 4096 \
  -smp 4 \
  -drive file=disk.qcow2,format=qcow2 \
  -netdev user,id=net0 -device virtio-net-pci,netdev=net0 \
  -serial mon:stdio \
  -nographic

# Avec VNC
qemu-system-x86_64 -enable-kvm -m 4096 -vnc :0 disk.qcow2

# Avec Tailscale (à l'intérieur de la VM)
# Installer tailscale dans la VM pour un accès distant

Dépannage

La VM ne démarre pas

# Vérifier si elle est verrouillée
ssh AGLSRV1 "qm status 104"

# Vérifier l'espace de stockage
ssh AGLSRV1 "pvesm status"

# Vérifier les logs
ssh AGLSRV1 "qm start 104 2>&1"

L'agent invité ne répond pas

# Vérifier s'il est activé
ssh AGLSRV1 "qm config 104 | grep agent"

# Vérifier à l'intérieur de la VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

Problèmes réseau

# Vérifier le pont
ssh AGLSRV1 "brctl show"

# Vérifier la configuration réseau de la VM
ssh AGLSRV1 "qm guest exec 104 -- ip a"

Notes

  • AGLWK45 (VM104) exécute la passerelle OpenClaw — éviter de redémarrer pendant des sessions actives
  • Les VMs QEMU utilisent les commandes qm dans Proxmox (contrairement à pct pour les conteneurs LXC)
  • L'agent invité permet la copie de fichiers, l'exécution de commandes et le gel du système de fichiers depuis l'hôte Proxmox
  • Toujours faire un snapshot avant des modifications importantes

Skills associés