Admin-Sistemas ·

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 image y Container si 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--disk-0. 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 pipefail

VMID=”${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, json

def 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@node02 funcione sin contraseña y que iptables -L INPUT -v -n | grep 22 permita el tráfico.

5.2 Error: “disk I/O error on RBD image”

  • Causa: El pool RBD está en modo read only por 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 con qm move_disk antes 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. Ajusta rbd default features a layering para 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 = 1 en Proxmox.
  • Probar la migración manualmente antes de automatizar.
  • Utilizar scripts y systemd para 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.