Correggere un machine-id duplicato dopo la clonazione VPS
Due VPS clonate con lo stesso /etc/machine-id possono contendersi il lease DHCP. Scopri i quattro comandi per rigenerarlo e azzerarlo prima dello snapshot.
Che cos’è /etc/machine-id e perché un duplicato è importante
Un VPS clonato si avvia con lo stesso /etc/machine-id del server da cui è stato clonato, ma quel valore dovrebbe appartenere a una sola installazione. La procedura corretta richiede quattro comandi: svuotare il file, rimuovere la copia D-Bus se è un file reale, rigenerare l’identificativo e riavviare. Il riavvio è il passaggio che spesso viene omesso, ma è quello che rende effettiva la modifica.
/etc/machine-id contiene una stringa esadecimale minuscola di 32 caratteri, terminata da un carattere di nuova riga. Decodificata, corrisponde a un valore di 16 byte (128 bit). La pagina di manuale di machine-id(5) la definisce riservata e specifica che non deve essere esposta sulla rete, perché chiunque la legga può riconoscere nuovamente la macchina in seguito. In genere viene generata durante l’installazione o al primo avvio e rimane invariata nei riavvii successivi.
In questo contesto vengono spesso confusi tre identificativi distinti, che è quindi utile separare. Il nome host è un’etichetta scelta dall’utente e può essere modificata in qualsiasi momento. L’UUID del prodotto DMI (desktop management interface) in /sys/class/dmi/id/product_uuid proviene dall’hypervisor ed è leggibile solo da root. Il machine ID è il terzo identificativo: viene generato dal sistema operativo e può essere letto da ogni utente della macchina.
Cosa legge effettivamente il machine ID
L’identificatore client DHCP. È questo il caso più problematico. ClientIdentifier= nella sezione [DHCPv4] di un file .network usa come fallback il valore impostato in networkd.conf(5), che per impostazione predefinita è duid: un identificatore client RFC 4361 composto da un IAID e da un DUID (DHCP unique identifier). networkd.conf(5) documenta il tipo DUID predefinito come vendor, in cui il valore DUID viene generato usando 43793 come identificatore del fornitore (systemd) e il contenuto sottoposto ad hash del machine ID. DHCPv6 usa lo stesso DUID. Due cloni con lo stesso machine ID producono lo stesso hash e quindi lo stesso DUID predefinito; se anche gli IAID coincidono, inviano un identificatore client identico a livello di byte. L’IAID generato automaticamente usa l’hash di un nome persistente ottenuto da udev e ricorre all’indirizzo MAC quando non è disponibile un nome prevedibile. La corrispondenza dei soli nomi correnti delle interfacce non garantisce la corrispondenza degli IAID; di conseguenza, indirizzi MAC diversi possono produrre identificatori client diversi nonostante machine ID e nomi delle interfacce siano identici. Quando gli identificatori client completi coincidono, il server DHCP vede un solo client invece di due e assegna a entrambi i server lo stesso lease. Il sintomo è un indirizzo che passa da un server all’altro oppure la perdita dell’indirizzo da parte di un server ogni volta che l’altro rinnova il lease.
journald. I file del journal persistente si trovano in /var/log/journal/<machine-id>/; i journal volatili si trovano in /run/log/journal/. La directory prende letteralmente il nome dall’ID. Un collector che raggruppa i journal in base al machine ID unisce le identità dei cloni; systemd-journal-remote separa invece i file di output in base al nome host o all’indirizzo dell’endpoint sorgente.
D-Bus. /var/lib/dbus/machine-id è il punto di origine di questo formato di file. Può essere un link simbolico a /etc/machine-id oppure un file reale separato che contiene una propria copia; questa copia è il problema nella procedura seguente.
Agent per host. Gli agent di monitoraggio, i controlli delle licenze, gli strumenti di inventario e i client di backup usano spesso il machine ID come identificatore host predefinito, perché è stabile e non richiede configurazione. Due server che comunicano la stessa identità producono un’unica serie di metriche aggregata oppure una sola licenza che copre due macchine. Verificare come l’agent ricava l’host ID, senza presumere che usi il nome host.
Come verificare se esiste un duplicato
Eseguire questo comando su entrambi i server e confrontare l’output.
cat /etc/machine-id
ls -l /var/lib/dbus/machine-id
sudo cat /sys/class/dmi/id/product_uuidID macchina identici su due server attivi indicano che uno è stato clonato dall’altro. Se si preferisce usare un solo comando, hostnamectl stampa lo stesso valore nella relativa riga Machine ID:.
Il risultato di ls -l determina il passaggio successivo. Un symlink ha questo aspetto:
lrwxrwxrwx 1 root root 15 Aug 21 09:12 /var/lib/dbus/machine-id -> /etc/machine-idUna riga che inizia con -rw-r--r-- indica che si tratta di un file reale che contiene una propria copia del vecchio ID. È necessario rimuoverlo, perché systemd-machine-id-setup lo legge prima di consultare l’UUID dell’hypervisor o il generatore casuale.
Anche l’UUID del prodotto è importante. systemd-machine-id-setup(1) usa l’UUID KVM prima di ricorrere alla generazione casuale. Se il provider ha assegnato a entrambi i cloni lo stesso UUID SMBIOS (BIOS di gestione del sistema), la rigenerazione da quella fonte produce due volte lo stesso ID macchina. UUID del prodotto diversi evitano questa specifica collisione, ma le fonti precedenti dell’ID hanno comunque la precedenza.
Rigenerare il machine ID su un VPS clonato
L’ordine è importante. systemd-machine-id-setup(1) controlla prima /run/machine-id, quindi un machine ID D-Bus valido, poi la credenziale system.machine_id, prima di provare un UUID configurato per la VM o il container e infine di generare un valore casuale. Lasciate un /var/lib/dbus/machine-id reale al suo posto e, a meno che /run/machine-id non abbia la precedenza, rigenererete esattamente il valore che stavate cercando di eliminare. Se lo strumento riutilizza /run/machine-id o una credenziale e l’ID rimane invariato, cancellate il machine ID dell’immagine mentre la macchina è arrestata e avviatela con origini dell’identità univoche.
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È necessario troncare prima il file, perché lo strumento agisce solo quando il file manca o è vuoto e non modifica un file che contiene già un ID valido. systemd-machine-id-setup comunica ciò che ha fatto sullo standard error. Su un VPS KVM che esegue systemd 258 o versioni successive, quando seleziona l’UUID dell’hypervisor, verrà visualizzato:
Initializing machine ID from SMBIOS/DMI UUID.systemd 255 descrive lo stesso passaggio come Initializing machine ID from VM UUID. Initializing machine ID from random generator. è il messaggio quando nessuna origine dell’ID precedente è utilizzabile. Entrambi i risultati sono corretti, purché cat /etc/machine-id ora restituisca un valore diverso da quello dell’altro server.
Il symlink mantiene D-Bus e systemd sullo stesso valore. Se preferite un file reale separato, eseguite sudo dbus-uuidgen --ensure al posto del comando per creare il symlink: quando il file D-Bus è assente, copia l’ID valido da /etc/machine-id. Se /var/lib/dbus è assente, ln termina con No such file or directory e potete omettere entrambe le righe.
Riavviate quindi il sistema.
sudo rebootPerché il riavvio non è facoltativo
Ogni processo che ha già letto il vecchio valore continua a usarlo. sd_id128_get_machine() memorizza nella cache l'ID per thread: un thread che lo ha già letto continua a restituire il vecchio valore, mentre solo un thread che non lo ha ancora richiesto legge il file modificato. Un demone in esecuzione può quindi mantenere il vecchio ID nei thread esistenti e acquisire quello nuovo soltanto nei thread avviati successivamente. journald ha già aperto /var/log/journal/<old-id>/system.journal e continua ad aggiungervi dati. systemd-networkd ha determinato il proprio DUID all'avvio e continua a inviare il vecchio identificatore client a ogni rinnovo. Questo è in genere esattamente il problema che si voleva risolvere. Anche D-Bus ha letto il proprio ID all'avvio. È possibile riavviare i servizi uno alla volta, ma se ne dimenticherà qualcuno. Anche PID 1 conserva il vecchio valore.
Dopo il riavvio, controllare entrambi gli aspetti:
cat /etc/machine-id
ls /var/log/journal/Con il logging persistente abilitato, /var/log/journal/ contiene ora una seconda directory con il nuovo ID nel nome e le nuove voci vengono scritte al suo interno. Il comando journalctl senza opzioni legge soltanto la directory della macchina corrente, quindi la cronologia precedente al clone scompare dalla visualizzazione predefinita. I dati sono ancora sul disco: journalctl --merge legge tutte le directory dei journal, inclusa quella precedente. Eliminare la vecchia directory quando si è certi di non aver più bisogno di quei log.
Per questo un container non è il luogo adatto per provare la procedura. Un container condivide il kernel dell'host. Può eseguire systemd come proprio PID 1, ma non avvia mai un kernel autonomo. All'interno di un container, systemd-machine-id-setup usa un UUID del container configurato soltanto dopo che le fonti di ID precedenti hanno fallito; se non è disponibile una fonte utilizzabile, genera un ID casuale. Eseguire il test nel modo in cui la procedura si svolge in produzione: clonare una VM, eseguire i comandi, riavviare e quindi confrontare l'ID con quello della macchina sorgente.
Azzera il file prima di creare lo snapshot, non dopo aver clonato
Correggere i cloni uno alla volta funziona. Correggere l'immagine è meglio, perché ogni server ripristinato da uno snapshot errato eredita lo stesso valore. Esegui questa operazione come ultimo passaggio prima di arrestare il template.
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 nowSvuota il file. Non eliminarlo. machine-id(5) consiglia di usare un file vuoto per le immagini utilizzate su più macchine, perché un file vuoto già presente consente di montare temporaneamente un file sopra quello reale tramite bind mount quando l'immagine viene usata in sola lettura. Su un /etc in sola lettura, l'ID generato all'avvio viene memorizzato in quel file temporaneo e systemd-machine-id-setup --commit lo scrive nel file una volta che il filesystem è scrivibile.
Un effetto collaterale dipende da come lasci il file. machine-id(5) specifica che, se /etc/machine-id esiste ed è vuoto, l'avvio non viene considerato il primo avvio; pertanto il file vuoto indicato sopra non attiva le unità che contengono ConditionFirstBoot=yes. Un file mancante o un file che contiene la stringa uninitialized fa invece sì che l'avvio successivo venga considerato il primo avvio: tali unità vengono eseguite e systemd applica anche i preset alle unità. Prima di creare il template, verifica quali operazioni eseguirebbe l'immagine con grep -rl ConditionFirstBoot /usr/lib/systemd/system/.
Un template e uno snapshot sono oggetti diversi, e questa differenza determina se l'identità viene copiata. Un template è un artefatto di build che prepari intenzionalmente, mentre uno snapshot è una copia in un determinato momento di un singolo server in esecuzione e conserva l'identità del server insieme ai suoi dati.
Perché le immagini cloud gestiscono correttamente questo aspetto mentre il tuo snapshot no
Le immagini cloud delle distribuzioni sono progettate per essere clonate. Per questo vengono distribuite con il machine ID non valorizzato e il primo avvio lo genera. cloud-init include un passaggio documentato proprio per questo scopo. cloud-init clean --machine-id imposta /etc/machine-id sulla stringa letterale uninitialized nei sistemi systemd. La documentazione di riferimento della CLI di cloud-init lo indica come procedura consigliata quando si clona una golden image. Al successivo avvio, l'immagine genera così un machine ID univoco.
Uno snapshot creato autonomamente è diverso. Il file era già valorizzato quando hai creato lo snapshot. Di conseguenza, ogni server ripristinato da quello snapshot mantiene lo stesso valore, a meno che il processo di ripristino non lo cancelli o sostituisca esplicitamente. È la stessa classe di problema che si verifica quando sposti un server in esecuzione su un nuovo VPS: la copia è fedele, ma l'identità è proprio l'elemento che non volevi copiare.
Cos’altro duplica un clone
- Chiavi host SSH. Anche
/etc/ssh/ssh_host_*viene copiato, quindi entrambi i server presentano ai client la stessa impronta. Rimuovi questi file ed eseguisudo ssh-keygen -Aoppuresudo dpkg-reconfigure openssh-serversu Debian e Ubuntu. In seguito i client segnaleranno una modifica della chiave host: è il comportamento corretto. - Il nome host. Impostalo con
sudo hostnamectl set-hostname app02, quindi verifica che/etc/hostsrisolva ancora il nuovo nome. - Configurazione di rete statica. Un clone di un sistema con un indirizzo statico entra in conflitto con l’originale non appena viene avviato. Leggi
/etc/netplan/prima che il clone si connetta alla rete. - L’orologio. Il ripristino di uno snapshot che include la memoria in esecuzione può lasciare indietro l’orologio del guest finché il guest o l’hypervisor non lo corregge. Un grande salto dell’orologio in un VPS ripristinato interrompe la validazione dei certificati TLS e altera l’ordine dei log finché la sincronizzazione dell’ora non recupera il ritardo.
Esegui anche sul clone la checklist dei primi dieci minuti per un nuovo VPS. Un sistema clonato eredita gli account utente, le chiavi SSH, le regole del firewall e i job pianificati del sistema di origine, ma nulla di tutto questo è stato verificato per il compito che il clone sta per svolgere.
FAQ
Devo riavviare dopo aver modificato /etc/machine-id?
Sì. Il software che ha già letto il machine ID continua a usare la copia memorizzata nella cache, quindi il nuovo valore non raggiunge le parti rilevanti di un sistema in esecuzione. journald continua a scrivere nella directory del journal associata al vecchio ID e il client DHCP continua a inviare un identificatore client derivato dal vecchio valore. Questo è in genere il motivo per cui lo si è modificato. Riavviare singoli servizi risolve il problema per alcuni di essi, ma anche PID 1 conserva il vecchio valore. Riavviare il sistema, quindi verificare con cat /etc/machine-id e confrontare il risultato con quello dell'altro server.
/etc/machine-id corrisponde all'UUID hardware?
No. Il product UUID DMI restituito da /sys/class/dmi/id/product_uuid proviene dall'hypervisor ed è leggibile soltanto da root. Il machine ID viene generato dal sistema operativo e risiede in un file di testo che qualsiasi utente può leggere. Il collegamento funziona in una sola direzione: su un guest KVM, systemd-machine-id-setup usa l'UUID dell'hypervisor come seme per un nuovo machine ID quando non si applica alcuna fonte di ID precedente. Se due cloni condividono lo stesso product UUID e la rigenerazione lo utilizza, genereranno lo stesso machine ID. Prima di considerare attendibile il risultato, confrontare quindi anche quel file.
Devo eliminare /etc/machine-id o lasciarlo vuoto?
Lasciarlo vuoto quando si prepara un'immagine. machine-id(5) preferisce un file vuoto, perché systemd può associare temporaneamente un file tramite bind mount, sostituendolo, quando l'immagine viene eseguita con un /etc in sola lettura. Eliminare il file funziona su un sistema scrivibile e alcuni script di clonazione adottano questo metodo, ma il file vuoto è l'impostazione predefinita più sicura. cloud-init scrive invece nel file la parola uninitialized. Questo valore, come un file mancante, fa sì che il boot successivo venga considerato un primo boot, quindi le unità con ConditionFirstBoot=yes vengono eseguite. Un file vuoto non produce questo comportamento.
Perché i due server clonati hanno ricevuto lo stesso indirizzo DHCP?
Perché hanno inviato lo stesso identificatore client. systemd-networkd usa per impostazione predefinita ClientIdentifier=duid per DHCPv4 e il DUID predefinito viene costruito a partire da un hash di /etc/machine-id. Machine ID identici producono quindi DUID predefiniti identici. Gli identificatori client completi coincidono soltanto quando coincidono anche gli IAID: systemd genera un IAID a partire da un nome persistente ottenuto da udev e ripiega sull'indirizzo MAC quando non è disponibile un nome prevedibile. La sola corrispondenza dei nomi correnti delle interfacce non garantisce questo risultato. Quando gli identificatori completi coincidono, il server DHCP usa quell'identificatore per associare le richieste, considera entrambe come provenienti dallo stesso client e assegna un unico lease. Assegnare a ogni macchina un proprio machine ID e riavviare entrambi i server. Se il server continua a proporre il vecchio indirizzo, eliminare il lease obsoleto direttamente dal server DHCP.