SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Cómo corregir un machine-id duplicado al clonar un VPS

Evita conflictos de DHCP entre clones que comparten /etc/machine-id. Vacíalo, regenera el identificador y reinicia; antes de crear la imagen, trúncalo.

Qué es /etc/machine-id y por qué importa que esté duplicado

Una VPS clonada arranca con el mismo /etc/machine-id que el servidor del que se clonó, aunque ese valor debe pertenecer a una sola instalación. La solución consta de cuatro comandos: vaciar el archivo, eliminar la copia de D-Bus si es un archivo real, regenerar el identificador y reiniciar. El reinicio es el paso que se suele omitir y es el que hace efectivo el cambio.

/etc/machine-id contiene una cadena hexadecimal en minúsculas, de 32 caracteres y terminada en salto de línea. Decodificada, equivale a un valor de 16 bytes (128 bits). La página del manual de machine-id(5) la considera confidencial e indica que no debe exponerse en la red, porque cualquier proceso que la lea puede volver a reconocer el equipo más adelante. Normalmente se genera durante la instalación o en el primer arranque y permanece constante en los arranques posteriores.

Aquí se suelen confundir tres identificadores, por lo que conviene diferenciarlos. El nombre de host es una etiqueta que se elige y se puede cambiar en cualquier momento. El UUID de producto de DMI (interfaz de gestión del escritorio) en /sys/class/dmi/id/product_uuid procede del hipervisor y sólo root puede leerlo. El machine ID es el tercero: lo genera el sistema operativo y cualquier usuario del equipo puede leerlo.

Qué lee realmente el ID de máquina

El identificador de cliente DHCP. Este es el problema más importante. ClientIdentifier= en la sección [DHCPv4] de un archivo .network recurre al valor establecido en networkd.conf(5), cuyo valor predeterminado es duid: un ID de cliente RFC 4361 creado a partir de un IAID y un DUID (identificador único DHCP). networkd.conf(5) documenta el tipo de DUID predeterminado como vendor, donde el valor del DUID se genera usando 43793 como identificador del proveedor (systemd) y el contenido del ID de máquina como entrada para un hash. DHCPv6 usa el mismo DUID. Dos clones con el mismo ID de máquina producen el mismo hash y, por tanto, el mismo DUID predeterminado. Si sus IAID también coinciden, envían un identificador de cliente idéntico byte a byte. El IAID generado automáticamente aplica un hash a un nombre persistente obtenido de udev y recurre a la dirección MAC cuando no hay un nombre predecible disponible. Que coincidan sólo los nombres actuales de las interfaces no garantiza que coincidan los IAID. Por tanto, distintas direcciones MAC pueden producir identificadores de cliente distintos aunque los ID de máquina y los nombres de las interfaces sean idénticos. Cuando coinciden los identificadores de cliente completos, el servidor DHCP ve un solo cliente en lugar de dos y ofrece la misma concesión a ambos equipos. El síntoma es una dirección que se mueve entre los dos servidores o que un servidor pierde su dirección cada vez que el otro renueva la concesión.

journald. Los archivos de journal persistentes se almacenan en /var/log/journal/<machine-id>/; los journals volátiles se almacenan en /run/log/journal/. El directorio recibe literalmente el nombre del ID. Un recopilador que agrupa los journals por ID de máquina fusiona las identidades de los clones; systemd-journal-remote separa los archivos de salida según el nombre de host o la dirección del endpoint de origen.

D-Bus. /var/lib/dbus/machine-id es el origen de este formato de archivo. Puede ser un enlace simbólico a /etc/machine-id o un archivo real independiente que contenga su propia copia. Esa copia es el problema del procedimiento siguiente.

Agentes por host. Los agentes de monitorización, las comprobaciones de licencias, las herramientas de inventario y los clientes de backup suelen usar el ID de máquina como identificador de host predeterminado, porque es estable y no requiere configuración. Que dos servidores notifiquen una sola identidad produce una única serie de métricas combinada o una sola licencia que cubre dos máquinas. Compruebe cómo obtiene el agente su ID de host en lugar de suponer que usa el nombre de host.

Cómo saber si tiene un duplicado

Ejecute esto en ambos servidores y compare la salida.

cat /etc/machine-id
ls -l /var/lib/dbus/machine-id
sudo cat /sys/class/dmi/id/product_uuid

Los ID de máquina idénticos en dos servidores activos indican que uno se clonó a partir del otro. hostnamectl muestra el mismo valor en su línea Machine ID: si prefiere usar un solo comando.

El resultado de ls -l determina el siguiente paso. Un enlace simbólico tiene este aspecto:

lrwxrwxrwx 1 root root 15 Aug 21 09:12 /var/lib/dbus/machine-id -> /etc/machine-id

Una línea que empieza por -rw-r--r-- indica que es un archivo real que contiene su propia copia del ID antiguo. Debe eliminarlo porque systemd-machine-id-setup lo lee antes de consultar el UUID del hipervisor o el generador aleatorio.

El UUID del producto también importa. systemd-machine-id-setup(1) usa primero el UUID de KVM y sólo recurre después a la generación aleatoria. Por tanto, si el proveedor asignó a ambos clones el mismo UUID de SMBIOS (BIOS de gestión del sistema), regenerar el ID desde ese origen produce dos veces el mismo ID de máquina. Los UUID de producto distintos evitan esa colisión concreta, pero los orígenes de ID anteriores siguen teniendo prioridad.

Regenerar el ID de máquina en un VPS clonado

El orden importa. systemd-machine-id-setup(1) comprueba primero /run/machine-id, después un ID de máquina de D-Bus válido, luego la credencial system.machine_id, después un UUID configurado de una máquina virtual o un contenedor y, por último, genera un valor aleatorio. Deje un /var/lib/dbus/machine-id real en su sitio y, salvo que /run/machine-id tenga prioridad, regenerará exactamente el valor que intentaba eliminar. Si la herramienta reutiliza /run/machine-id o una credencial y el ID no cambia, borre el ID de máquina de la imagen mientras esté apagada y arránquela con fuentes de identidad únicas.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id       # only if ls -l showed a real file
sudo systemd-machine-id-setup
sudo ln -sf /etc/machine-id /var/lib/dbus/machine-id
cat /etc/machine-id

Es necesario truncar el archivo primero, porque la herramienta sólo actúa cuando el archivo no existe o está vacío. Si el archivo ya contiene un ID válido, no hace nada. systemd-machine-id-setup informa de lo que hizo por la salida de error estándar. En un VPS KVM que ejecute systemd 258 o posterior, cuando selecciona el UUID del hipervisor, verá:

Initializing machine ID from SMBIOS/DMI UUID.

systemd 255 describe el mismo paso como Initializing machine ID from VM UUID. Initializing machine ID from random generator. es el mensaje cuando no se puede usar ninguna fuente de ID anterior. Cualquiera de los dos resultados es correcto, siempre que cat /etc/machine-id muestre ahora un valor diferente del del otro servidor.

El enlace simbólico mantiene D-Bus y systemd con un solo valor. Si prefiere un archivo real independiente, ejecute sudo dbus-uuidgen --ensure en lugar del comando del enlace simbólico: cuando falta el archivo de D-Bus, copia el ID válido de /etc/machine-id. Si /var/lib/dbus no existe, ln falla con No such file or directory, y puede omitir esas dos líneas.

Después, reinicie.

sudo reboot

Por qué el reinicio no es opcional

Todos los procesos que ya leyeron el valor antiguo siguen utilizándolo. sd_id128_get_machine() almacena en caché el ID por subproceso: un subproceso que ya lo leyó sigue devolviendo el valor antiguo, y sólo un subproceso que todavía no lo ha solicitado lee el archivo modificado. Por tanto, un daemon en ejecución puede conservar el ID antiguo en sus subprocesos existentes y obtener el nuevo sólo en los subprocesos que inicie después. journald ya tiene /var/log/journal/<old-id>/system.journal abierto y sigue añadiendo datos. systemd-networkd calculó su DUID al iniciarse y sigue enviando el identificador de cliente antiguo en cada renovación, que normalmente es exactamente el problema que se pretendía corregir. D-Bus también leyó su ID al iniciarse. Puede reiniciar los servicios uno por uno, pero olvidará alguno, y PID 1 también conserva el valor antiguo.

Después del reinicio, compruebe ambas partes:

cat /etc/machine-id
ls /var/log/journal/

Con el registro persistente habilitado, /var/log/journal/ ahora contiene un segundo directorio cuyo nombre corresponde al ID nuevo, y las entradas nuevas se escriben allí. journalctl sin opciones sólo lee el directorio de la máquina actual, por lo que el historial anterior a la clonación desaparece de la vista predeterminada. Sigue estando en el disco: journalctl --merge lee todos los directorios del journal, incluido el antiguo. Elimine el directorio antiguo cuando tenga la certeza de que ya no necesita esos registros.

Por este mismo motivo, un contenedor no es el lugar adecuado para ensayar el procedimiento. Un contenedor comparte el kernel del host. Puede ejecutar systemd como su propio PID 1, pero nunca inicia un kernel propio. Dentro de un contenedor, systemd-machine-id-setup usa un UUID de contenedor configurado sólo después de que fallen las fuentes de ID anteriores; sin una fuente utilizable, genera un ID aleatorio. Pruébelo como ocurrirá en producción: clone una VM, ejecute los comandos, reinicie y compare el ID con el de la máquina de origen.

Trunque antes de crear la instantánea, no después de clonar

Corregir los clones uno por uno funciona. Corregir la imagen es mejor, porque todos los servidores restaurados desde una instantánea incorrecta heredan el mismo valor. Haga esto justo antes de apagar la plantilla.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo ln -s /etc/machine-id /var/lib/dbus/machine-id
sudo shutdown -h now

Vacíe el archivo. No lo elimine. machine-id(5) recomienda un archivo vacío para las imágenes que se usan en varias máquinas, porque un archivo vacío en su ubicación permite montar temporalmente otro archivo mediante bind mount sobre el archivo real cuando la imagen se usa en modo de solo lectura. En un /etc de solo lectura, el ID generado durante el arranque se guarda en ese archivo temporal y systemd-machine-id-setup --commit lo escribe una vez que el sistema de archivos permite escritura.

Un efecto secundario depende de cómo deje el archivo. machine-id(5) especifica que, si existe /etc/machine-id y está vacío, el arranque no se considera el primero. Por tanto, el archivo vacío anterior no activa las unidades que llevan ConditionFirstBoot=yes. Si falta el archivo o contiene la cadena uninitialized, el siguiente arranque sí se considera el primero: esas unidades se ejecutan y systemd también aplica los presets a las unidades. Consulte qué ejecutaría su imagen con grep -rl ConditionFirstBoot /usr/lib/systemd/system/ antes de crear la plantilla.

Una plantilla y una instantánea son objetos distintos, y esa diferencia determina si se copia la identidad. Una plantilla es un artefacto de compilación que se prepara de forma intencionada, mientras que una instantánea es una copia puntual de un servidor en ejecución y conserva la identidad de ese servidor junto con sus datos.

Por qué las imágenes de nube resuelven esto y su snapshot no

Las imágenes de nube de las distribuciones se crean para clonarse. Por eso se distribuyen con el ID de máquina sin establecer y el primer arranque lo genera. cloud-init incluye un paso documentado exactamente para este caso. cloud-init clean --machine-id establece /etc/machine-id en la cadena literal uninitialized en sistemas systemd. La referencia de la CLI de cloud-init lo describe como una práctica recomendada al clonar una imagen maestra. De este modo, el siguiente arranque de esa imagen genera un ID de máquina único.

Un snapshot que creó usted mismo es diferente. El archivo ya contenía un valor cuando creó el snapshot. Por tanto, cada servidor restaurado a partir de él conserva ese valor, salvo que el proceso de restauración lo elimine o lo sustituya explícitamente. Es el mismo tipo de problema que mover un servidor en ejecución a un VPS nuevo, donde la copia es fiel y la identidad es la parte que no quería copiar.

Qué más duplica un clon

  • Claves de host de SSH. También se copia /etc/ssh/ssh_host_*, por lo que ambos servidores presentan la misma huella digital a los clientes. Elimine esos archivos y ejecute sudo ssh-keygen -A o sudo dpkg-reconfigure openssh-server en Debian y Ubuntu. Después, sus clientes advertirán de que la clave de host ha cambiado. Ese es el comportamiento correcto.
  • El nombre de host. Establézcalo con sudo hostnamectl set-hostname app02 y compruebe que /etc/hosts siga resolviendo el nombre nuevo.
  • Configuración de red estática. Un clon de un equipo con una dirección estática entra en conflicto con el original en cuanto se inicia. Lea /etc/netplan/ antes de conectar el clon a la red.
  • El reloj. Restaurar una instantánea que incluye memoria en ejecución puede dejar atrasado el reloj del invitado hasta que el invitado o el hipervisor lo corrija. Un salto grande del reloj en un VPS restaurado interrumpe la validación de certificados TLS y desordena los registros hasta que la sincronización horaria se pone al día.

Siga también en el clon la lista de comprobación de los primeros diez minutos para un VPS nuevo. Un equipo clonado hereda las cuentas de usuario, las claves de SSH, las reglas del firewall y las tareas programadas del equipo de origen. Nada de eso se revisó para la función que el clon está a punto de desempeñar.

FAQ

¿Tengo que reiniciar después de cambiar /etc/machine-id?

Sí. El software que ya leyó el machine ID conserva la copia almacenada en caché, por lo que el valor nuevo no llega a las partes relevantes de un sistema en ejecución. journald sigue escribiendo en el directorio del journal cuyo nombre corresponde al ID antiguo, y el cliente DHCP sigue enviando un identificador de cliente derivado del valor antiguo, que normalmente es el motivo por el que lo cambió. Reiniciar servicios individuales corrige algunos casos, pero PID 1 también conserva el valor antiguo. Reinicie y confirme con cat /etc/machine-id; después, compare el resultado con el del otro servidor.

¿/etc/machine-id es lo mismo que el UUID del hardware?

No. El UUID de producto DMI de /sys/class/dmi/id/product_uuid procede del hipervisor y sólo root puede leerlo. El machine ID lo genera el sistema operativo y se almacena en un archivo de texto que cualquier usuario puede leer. La relación funciona en una sola dirección: en un guest KVM, systemd-machine-id-setup usa el UUID del hipervisor como semilla para generar un machine ID nuevo cuando no se aplica ninguna fuente de ID anterior. Si dos clones comparten el mismo UUID de producto y la regeneración lo utiliza, generarán el mismo machine ID. Por tanto, compruebe también ese archivo antes de confiar en el resultado.

¿Debo eliminar /etc/machine-id o dejarlo vacío?

Déjelo vacío al preparar una imagen. machine-id(5) prefiere un archivo vacío, porque systemd puede montar mediante bind un archivo temporal sobre él cuando la imagen se ejecuta con un /etc de sólo lectura. Eliminar el archivo funciona en un sistema con permisos de escritura y algunos scripts de clonación lo hacen así, pero el archivo vacío es la opción predeterminada más segura. En cambio, cloud-init escribe la palabra uninitialized en el archivo. Ese valor, al igual que un archivo inexistente, hace que el siguiente arranque se considere el primero, por lo que las unidades con ConditionFirstBoot=yes se ejecutan en él. Un archivo vacío no produce ese comportamiento.

¿Por qué mis dos servidores clonados obtuvieron la misma dirección DHCP?

Porque ambos enviaron el mismo identificador de cliente. systemd-networkd usa ClientIdentifier=duid de forma predeterminada para DHCPv4, y el DUID predeterminado se construye a partir de un hash de /etc/machine-id. Por ello, unos machine IDs idénticos producen unos DUID predeterminados idénticos. Los identificadores de cliente completos sólo coinciden cuando también coinciden los IAID: systemd genera un IAID a partir de un nombre persistente obtenido de udev y recurre a la dirección MAC cuando no hay un nombre predecible disponible. Que sólo coincidan los nombres actuales de las interfaces no garantiza que esto ocurra. Cuando los identificadores completos coinciden, el servidor DHCP identifica ambas solicitudes mediante ese identificador, las trata como procedentes del mismo cliente y asigna una única concesión. Asigne a cada equipo su propio machine ID y reinicie ambos. Si el servidor sigue ofreciendo la dirección antigua, elimine la concesión obsoleta directamente en el servidor DHCP.

¿Te resultó útil este artículo?

#machine-id#systemd#cloning#snapshots#dhcp