← volver

Guía paso a paso para habilitar y automatizar Live Migration en Proxmox con Ceph RBD

Por · · [Admin-Sistemas] · lectura estimada: ~6 min

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=$2

Verificar 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 pveperf y ajusta migration_bandwidth en /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.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal