Guía paso a paso para habilitar y automatizar Live Migration en Proxmox con Ceph RBD
Introducción
Live Migration (migración en vivo) permite mover una máquina virtual (VM) en ejecución de un nodo de Proxmox a otro sin interrupción del servicio. Para que la migración sea sin estado (sin copiar discos), ambos nodos deben compartir el mismo backend de almacenamiento. En entornos productivos Ceph RBD es la solución más flexible y escalable, ya que brinda un shared block device accesible desde todos los nodos del clúster.
Este artículo muestra, paso a paso, cómo:
- Instalar y configurar Ceph en los nodos de Proxmox.
- Crear un pool RBD y una imagen que servirá como disco para las VMs.
- Configurar Proxmox para usar Ceph como storage compartido.
- Habilitar y probar la migración en vivo.
- Automatizar la migración mediante scripts y
systemd.
Se asume que ya tienes un clúster de Proxmox VE (versión 8.x) con al menos dos nodos y acceso root por ssh. La guía está escrita para Debian‑based, pero los conceptos son aplicables a cualquier distribución soportada por Proxmox.
1. Instalación y configuración básica de Ceph
1.1 Preparar los nodos
En cada nodo de Proxmox, instala los paquetes de Ceph:
# apt update
# apt install -y ceph ceph-common ceph-fuse
Verifica que el kernel tenga soporte para RBD (normalmente viene incluido en kernels modernos). Si necesitas cargar el módulo:
# modprobe rbd
1.2 Crear el cluster Ceph
Elige un nodo como monitor (MON). Ejecuta:
# ceph-deploy new node01
Agrega los demás monitores (opcional) y los OSDs (Object Storage Daemons). Por ejemplo, si cada nodo tiene un disco /dev/sdb destinado a Ceph:
# ceph-deploy osd create node01:/dev/sdb node02:/dev/sdb node03:/dev/sdb
Una vez creados los OSDs, inicializa el cluster:
# ceph-deploy mon create-initial
Comprueba el estado:
# ceph -s
Deberías ver algo como HEALTH_OK y los monitores/OSDs activos.
1.3 Configurar el pool RBD
Crearemos un pool llamado rbd (el nombre por defecto) con 128 PB de espacio y replicación 3 (ajusta según tu número de OSDs):
# ceph osd pool create rbd 128
# ceph osd pool set rbd size 3
# ceph osd pool set rbd min_size 2
Habilita la característica erasure coding solo si necesitas más eficiencia; para migraciones en vivo la replicación simple es suficiente.
2. Integración de Ceph RBD en Proxmox
2.1 Añadir el storage en la UI
Desde la interfaz web de Proxmox, ve a Datacenter → Storage → Add → RBD y completa:
- ID:
ceph-rbd - Monitores: lista de IPs de los MONs (ej.
10.0.0.1,10.0.0.2,10.0.0.3) - Pool:
rbd - Username:
admin - Keyring:
/etc/pve/ceph.client.admin.keyring - Marca Content como
Disk imageyContainersi usas LXC.
Guarda. Proxmox ahora muestra el storage ceph-rbd en todos los nodos.
2.2 Crear una VM usando Ceph RBD
Al crear una nueva VM, elige ceph-rbd como disco. Proxmox automáticamente creará una imagen RBD con nombre vm-. Por ejemplo:
# qm create 101 --name test-vm --memory 2048 --net0 virtio,bridge=vmbr0
# qm set 101 --scsihw virtio-scsi-pci --scsi0 ceph-rbd:vm-101-disk-0,format=raw,size=20G
El formato raw es recomendado para rendimiento con Ceph.
3. Habilitar Live Migration
3.1 Configuración del clúster para migración
En cada nodo, edita /etc/pve/datacenter.cfg (o vía UI > Datacenter > Options) y habilita la migración:
# Enable migration with shared storage
migration = 1
Asegúrate de que SSH root login sin password está configurado entre los nodos, ya que Proxmox usa SSH para orquestar la migración:
# ssh-keygen -t ed25519 -N "" -f /root/.ssh/id_ed25519
# ssh-copy-id -i /root/.ssh/id_ed25519.pub root@node02
# ssh-copy-id -i /root/.ssh/id_ed25519.pub root@node03
3.2 Probar la migración manual
Desde la UI, selecciona la VM → Migrate, elige el nodo destino y pulsa Start. Alternativamente, con la línea de comandos:
# qm migrate 101 node02 --online
El flag --online indica que la VM debe mantenerse encendida. Proxmox copiará la RAM mediante qemu y, como los discos están en Ceph RBD, no hay transferencia de datos de bloque.
3.3 Verificar el resultado
Una vez finalizada, comprueba que la VM está en el nodo destino:
# qm status 101
Y que el disco sigue apuntando a ceph-rbd:
# qm config 101 | grep scsi0
4. Automatización de Live Migration
4.1 Script básico de migración
Crearemos un script /usr/local/bin/pve-live-migrate.sh que reciba la VM ID y el nodo destino:
#!/bin/bash set -euo pipefailVMID=”${1?Uso: $0 <VMID> <DESTINO>}” DEST=”${2?Uso: $0 <VMID> <DESTINO>}”
Validar que la VM exista
if ! qm status “$VMID” &>/dev/null; then echo “VM $VMID no existe” exit 1 fi
Verificar que el nodo destino sea distinto
CURRENT=$(qm config “$VMID” | grep -i “^node:” | awk ‘{print $2}’) if [[ “$CURRENT” == “$DEST” ]]; then echo “La VM ya está en $DEST” exit 0 fi
echo “Iniciando migración online de VM $VMID a $DEST …” qm migrate “$VMID” “$DEST” —online
echo “Migración completada.”
Hazlo ejecutable:
# chmod +x /usr/local/bin/pve-live-migrate.sh
4.2 Systemd timer para migraciones programadas
Supongamos que queremos mover VMs de carga ligera a nodos menos usados cada noche. Creamos un service y un timer.
Archivo de servicio: /etc/systemd/system/pve-migrate.service
[Unit] Description=Live Migration de VMs según política After=network.target
[Service] Type=oneshot ExecStart=/usr/local/bin/pve-live-migrate.sh 101 node03 ExecStart=/usr/local/bin/pve-live-migrate.sh 102 node02
Timer: /etc/systemd/system/pve-migrate.timer
[Unit] Description=Ejecuta pve-migrate.service cada día a las 02:00[Timer] OnCalendar=--* 02:00:00 Persistent=true
[Install] WantedBy=timers.target
Habilita y arranca el timer:
# systemctl daemon-reload
# systemctl enable --now pve-migrate.timer
Con esto, cada noche a las 02:00 se ejecutarán las migraciones definidas.
4.3 Extender la lógica con una política basada en carga
Para algo más avanzado, podemos consultar la carga del nodo vía pveperf o ceph status y decidir dinámicamente el destino. Un ejemplo rápido:
#!/usr/bin/env python3 import subprocess, jsondef node_load(node): out = subprocess.check_output([“pveperf”, node]) # Parse simple “cpu: 2.3%” pattern for line in out.decode().splitlines(): if line.startswith(“cpu”): return float(line.split()[1].strip(’%’)) return 100.0
nodes = [“node01”,“node02”,“node03”] loads = {n: node_load(n) for n in nodes} dest = min(loads, key=loads.get)
migrar todas las VMs marcadas como “lowload”
vm_list = subprocess.check_output([“qm”, “list”, “—full”, “—output”, “json”]).decode() vms = json.loads(vm_list) for vm in vms: if vm[“tags”] and “lowload” in vm[“tags”]: subprocess.run([“qm”,“migrate”,str(vm[“vmid”]),dest,“—online”])
Este script puede usarse como ExecStart del service para decidir el nodo en tiempo real.
Troubleshooting
5.1 Error: “migration failed: could not connect to destination node”
- Causa: SSH key no sincronizada o firewall bloquea el puerto 22.
- Solución: Verifica que
ssh root@node02funcione sin contraseña y queiptables -L INPUT -v -n | grep 22permita el tráfico.
5.2 Error: “disk I/O error on RBD image”
- Causa: El pool RBD está en modo
read onlypor falta de quorum. - Solución: Revisa el estado de Ceph:
ceph -s. Recupera monitores caídos o agrega OSDs para restablecer quorum.
5.3 La VM se reinicia después de la migración
- Causa: La VM estaba usando un disco local (no RBD) o una configuración
--with-local-disks. - Solución: Asegúrate de que todos los discos estén en
ceph-rbd. Puedes mover un disco local a RBD conqm move_diskantes de migrar.
5.4 Latencia alta durante la migración
- Causa: Ancho de banda insuficiente entre nodos o saturación del cluster Ceph.
- Solución: Mejora la red (10 GbE recomendado) y revisa
ceph osd perf. Ajustarbd default featuresalayeringpara reducir copias.
Conclusión
Configurar Live Migration en Proxmox con Ceph RBD como almacenamiento compartido brinda una infraestructura resiliente y altamente disponible. La clave está en:
- Un cluster Ceph saludable y bien dimensionado.
- Almacenar los discos de las VMs en un pool RBD accesible desde todos los nodos.
- Configurar SSH sin contraseña y habilitar la opción
migration = 1en Proxmox. - Probar la migración manualmente antes de automatizar.
- Utilizar scripts y
systemdpara orquestar migraciones programadas o basadas en carga.
Con estos pasos, los sysadmins podrán mover VMs en tiempo real, equilibrar la carga del clúster y minimizar el downtime, manteniendo al mismo tiempo una arquitectura de almacenamiento escalable y tolerante a fallos.