Guía paso a paso para habilitar y automatizar Live Migration en Proxmox con Ceph RBD
Introducción
La migración en vivo (Live Migration) permite trasladar una máquina virtual (VM) de un nodo de Proxmox a otro sin interrumpir su funcionamiento. Cuando el storage es Ceph RBD, el proceso se vuelve más sencillo porque el disco está disponible simultáneamente para todos los nodos del cluster. Sin embargo, para garantizar una migración fiable es necesario:
- Configurar correctamente la red de migración.
- Crear pools RBD y mapearlos en cada nodo.
- Habilitar y probar la migración en modo manual.
- Automatizar el proceso y añadir mecanismos de verificación y fallback.
En este artículo vamos a cubrir cada uno de estos pasos, con comandos reales, ejemplos de configuración y una sección de troubleshooting para los errores más comunes.
1. Preparación del entorno
1.1 Requisitos de hardware y software
Para seguir este tutorial necesitas al menos tres nodos físicos con:
- CPU con virtualización VT-x/AMD‑V habilitada.
- 2 GB de RAM mínima por nodo (recomendado 8 GB).
- Conexión de red de alta velocidad (10 GbE recomendado) para la migración.
- Proxmox VE 7.x o superior instalado.
- Ceph Octopus (15.x) o superior configurado como cluster de almacenamiento.
1.2 Configuración básica de red en Proxmox
Proxmox necesita una red dedicada para la migración (p.ej. vmbr1). Añade la interfaz en /etc/network/interfaces:
auto vmbr1
iface vmbr1 inet static
address 10.10.10.1/24
bridge_ports eth1
bridge_stp off
bridge_fd 0
Repite el mismo bloque en los demás nodos, ajustando la dirección IP (10.10.10.2, 10.10.10.3, etc.). Después, reinicia la red:
systemctl restart networking
1.3 Verificar conectividad entre nodos
Comprueba que los nodos se pueden "pinguear" y que el puerto 8006 (API de Proxmox) y el puerto 111 (RPC) están abiertos:
ping -c 3 10.10.10.2
nc -zvw3 10.10.10.2 8006
nc -zvw3 10.10.10.2 111
2. Configuración de Ceph RBD como storage compartido
2.1 Crear un pool RBD dedicado a VMs
En el nodo monitor (mon1) ejecuta:
ceph osd pool create vm-pool 128 128 replicated
ceph osd pool set vm-pool size 3
ceph osd pool set vm-pool min_size 2
Esto crea un pool llamado vm-pool con 128 placement groups y una replicación de 3 (ajusta según tu número de OSDs).
2.2 Crear un usuario RBD para Proxmox
ceph auth get-or-create client.proxmox mon 'allow r' osd 'allow class-read object_prefix rbd_children, allow rwx pool=vm-pool'
Guarda la clave que devuelve el comando; la necesitarás en la interfaz web de Proxmox.
2.3 Añadir el storage RBD a Proxmox
Desde la GUI, ve a Datacenter → Storage → Add → RBD**. Completa los campos:
- Storage ID:
ceph-rbd - Monitors:
10.0.0.1,10.0.0.2,10.0.0.3(IP de los monitores) - Pool:
vm-pool - Username:
client.proxmox - Password: la clave del paso anterior
- Content:
Disk image - Nodes: selecciona todos los nodos.
Guarda y repite la operación en cada nodo (o usa la API para propagar).
2.4 Verificar que las VMs usan el pool RBD
Crea una VM de prueba desde la GUI y elige ceph-rbd como disco. Después, verifica en la línea de comandos:
qm list
rbd -p vm-pool ls -l
3. Habilitar y probar Live Migration manual
3.1 Activar la migración en modo "offline"
En Datacenter → Options** habilita:
- Migration type:
live - Migration network:
vmbr1
3.2 Migrar una VM manualmente
Ejemplo con VM ID 101 desde node1 a node2:
qm migrate 101 node2 --online
El flag --online indica que la migración será en vivo.
3.3 Verificar consistencia post‑migración
Después de la migración, ejecuta:
qm status 101
rbd -p vm-pool info vm-101-disk-0
Comprueba que el estado sea running y que el tamaño del disco coincida con el pre‑migración.
3.4 Habilitar la migración automática con pve-manager
Proxmox incluye pve-migrate como herramienta de automatización. Crea un script simple (/usr/local/bin/auto-migrate.sh) que reciba el VM ID y el nodo destino:
#!/bin/bash VMID=$1 DEST=$2Verificar que la VM está en estado running
if [[ $(qm status $VMID | awk ‘{print $2}’) != “running” ]]; then echo “VM $VMID no está en ejecución, abortando.” exit 1 fi
Ejecutar migración
qm migrate $VMID $DEST —online
Comprobar código de salida
if [[ $? -eq 0 ]]; then echo “Migración completada con éxito.” else echo “Fallo en la migración, iniciando fallback.” # Fallback: revertir al nodo original ORIG=$(qm config $VMID | grep ^node: | awk ‘{print $2}’) qm migrate $VMID $ORIG —online fi
Haz el script ejecutable:
chmod +x /usr/local/bin/auto-migrate.sh
4. Automatización avanzada y mecanismos de fallback
4.1 Uso de systemd timers para migraciones programadas
Supongamos que quieres balancear la carga cada noche. Crea un unit /etc/systemd/system/auto-migrate@.service:
[Unit] Description=Auto migrate VM %i After=network.target[Service] Type=oneshot ExecStart=/usr/local/bin/auto-migrate.sh %i $(/usr/bin/pveperf | awk ‘/node/ {print $2}’ | shuf -n1)
Y un timer /etc/systemd/system/auto-migrate@.timer:
[Unit] Description=Timer for auto migrate VM %i[Timer] OnCalendar=--* 02:00:00 RandomizedDelaySec=300 Persistent=true
[Install] WantedBy=timers.target
Habilita el timer para una VM concreta (p.ej. VM 101):
systemctl enable --now auto-migrate@101.timer
4.2 Verificación de consistencia con snapshots
Antes de iniciar la migración, crea un snapshot RBD para poder volver atrás en caso de corrupción:
rbd snap create vm-pool/vm-101-disk-0@pre-migrate
rbd snap protect vm-pool/vm-101-disk-0@pre-migrate
Si la migración falla, el script de fallback puede restaurar el snapshot:
rbd snap rollback vm-pool/vm-101-disk-0@pre-migrate
4.3 Monitoreo y alertas con prometheus + node_exporter
Exporta la métrica pve_migration_success_total y crea una regla de alerta:
alert: LiveMigrationFailed
expr: rate(pve_migration_success_total[5m]) == 0
for: 10m
labels:
severity: critical
annotations:
summary: "Falló la migración en los últimos 10 minutos"
description: "Revisa los logs de {{ $labels.instance }}."
5. Troubleshooting
5.1 Error común: “migration failed: handshake error”
- Causa: la red de migración no está configurada o hay firewall bloqueando el puerto 2222.
- Solución:
iptables -I INPUT -p tcp --dport 2222 -j ACCEPT # o en firewalld firewall-cmd --add-port=2222/tcp --permanent firewall-cmd --reload
5.2 Error: “RBD image not found”
- Causa: el pool RBD no está mapeado en el nodo destino.
- Solución:
ceph auth get-or-create client.admin mon 'allow *' osd 'allow *' -o /etc/ceph/ceph.client.admin.keyring rbd map vm-pool/vm-101-disk-0 --pool vm-pool --id client.proxmox
5.3 Fallback no funciona porque el snapshot está protegido
- Causa: el snapshot se marcó como protegido y no se puede eliminar.
- Solución:
rbd snap unprotect vm-pool/vm-101-disk-0@pre-migrate rbd snap rm vm-pool/vm-101-disk-0@pre-migrate
5.4 Alta latencia en la migración
- Causa: congestión en la red de migración o uso de discos no SSD en OSDs.
- Solución:
- Utiliza QoS en el switch (VLAN dedicada).
- Distribuye los OSDs en discos SSD/NVMe.
- Revisa
pveperfy ajustamigration_bandwidthen/etc/pve/datacenter.cfg.
Conclusión
Configurar Live Migration de KVM en Proxmox con Ceph RBD como storage compartido brinda alta disponibilidad y facilita el balanceo de carga sin tiempo de inactividad. Siguiendo los pasos descritos —preparar la red, crear pools RBD, habilitar la migración, y automatizar con scripts y systemd timers— obtendrás un entorno robusto. Además, la inclusión de snapshots y alertas garantiza que cualquier fallo pueda ser detectado y revertido rápidamente, manteniendo la consistencia de los datos.
Recuerda validar cada fase en un entorno de pruebas antes de aplicarlo en producción, y adaptar los valores de replicación y QoS a las características específicas de tu infraestructura.