SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Corrigir machine-id duplicado após clonar uma VPS

Duas VPS clonadas com o mesmo /etc/machine-id podem disputar o lease DHCP. Veja os 4 comandos para regenerar o valor e limpe-o antes do snapshot.

O que é o /etc/machine-id e por que uma duplicação é importante

Um VPS clonado arranca com o mesmo /etc/machine-id que o servidor de origem do clone, mas esse valor deve pertencer a exatamente uma instalação. A correção consiste em 4 comandos: esvaziar o ficheiro, remover a cópia do D-Bus se for um ficheiro real, gerar um novo valor e reiniciar. O reinício é o passo que muitas pessoas ignoram, mas é ele que aplica a alteração.

/etc/machine-id contém uma cadeia hexadecimal em minúsculas, terminada por uma quebra de linha e com 32 caracteres. Descodificado, esse valor corresponde a 16 bytes (128 bits). A página de manual do machine-id(5) classifica-o como confidencial e indica que não deve ser exposto na rede, porque qualquer sistema que o leia poderá voltar a reconhecer a sua máquina mais tarde. Normalmente, o valor é gerado durante a instalação ou no primeiro arranque e permanece constante nos arranques seguintes.

É comum confundir 3 identificadores neste contexto, por isso vale a pena distingui-los. O hostname é um rótulo escolhido pelo administrador e pode ser alterado a qualquer momento. O UUID do produto DMI (desktop management interface) em /sys/class/dmi/id/product_uuid vem do hypervisor e só pode ser lido por root. O machine ID é o terceiro: o sistema operativo gera-o e qualquer utilizador do sistema pode lê-lo.

O que efetivamente lê o ID da máquina

O identificador do cliente DHCP. Este é o caso mais problemático. ClientIdentifier= na secção [DHCPv4] de um ficheiro .network recorre ao valor definido em networkd.conf(5), que por predefinição é duid: um identificador de cliente RFC 4361 criado a partir de um IAID e de um DUID (identificador único DHCP). networkd.conf(5) documenta o tipo de DUID predefinido como vendor, em que o valor do DUID é gerado usando 43793 como identificador do fornecedor (systemd) e o conteúdo com hash do ID da máquina. O DHCPv6 usa o mesmo DUID. Dois clones com o mesmo ID da máquina produzem o mesmo hash e, portanto, o mesmo DUID predefinido. Se os IAID também coincidirem, enviam um identificador de cliente byte a byte idêntico. O IAID gerado automaticamente calcula o hash de um nome persistente obtido através do udev e recorre ao endereço MAC quando não existe um nome previsível. A correspondência apenas dos nomes atuais das interfaces não garante IAID idênticos. Por isso, endereços MAC diferentes podem produzir identificadores de cliente diferentes, apesar de os IDs da máquina e os nomes das interfaces serem iguais. Quando os identificadores de cliente completos coincidem, o servidor DHCP vê um cliente em vez de dois e oferece a mesma concessão aos dois servidores. O sintoma é um endereço que passa de um servidor para o outro, ou um servidor que perde o endereço sempre que o outro renova a concessão.

journald. Os ficheiros de journal persistentes ficam em /var/log/journal/<machine-id>/; os journals voláteis ficam em /run/log/journal/. O diretório tem literalmente o nome do ID. Um coletor que agrupe journals pelo ID da máquina mistura as identidades dos clones; systemd-journal-remote separa os ficheiros de saída pelo nome de host ou endereço do endpoint de origem.

D-Bus. /var/lib/dbus/machine-id é o local onde este formato de ficheiro foi criado. Pode ser um link simbólico para /etc/machine-id ou um ficheiro real separado que contém a sua própria cópia. Essa cópia é a armadilha do procedimento abaixo.

Agentes por host. Os agentes de monitorização, as verificações de licenças, as ferramentas de inventário e os clientes de backup usam frequentemente o ID da máquina como identificador de host predefinido, porque é estável e não requer configuração. Dois servidores que comuniquem uma única identidade produzem uma única série de métricas agregada, ou uma licença que abrange duas máquinas. Verifique como o seu agente obtém o ID do host, em vez de assumir que usa o nome de host.

Como saber se você tem um duplicado

Execute isto nos dois servidores e compare a saída.

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

IDs de máquina idênticos em dois servidores ativos indicam que um foi clonado a partir do outro. hostnamectl mostra o mesmo valor na linha Machine ID: se preferir usar um único comando.

O resultado de ls -l determina o próximo passo. Um link simbólico aparece assim:

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

Uma linha que começa com -rw-r--r-- indica que se trata de um ficheiro real que contém a sua própria cópia do ID antigo. É necessário removê-lo, porque systemd-machine-id-setup lê esse ficheiro antes de consultar o UUID do hypervisor ou o gerador aleatório.

O UUID do produto também é relevante. systemd-machine-id-setup(1) usa o UUID do KVM antes de recorrer à geração aleatória. Portanto, se o fornecedor atribuiu aos dois clones o mesmo UUID SMBIOS (BIOS de gestão do sistema), gerar o ID a partir dessa origem produzirá o mesmo ID de máquina duas vezes. UUIDs de produto diferentes evitam essa colisão específica, mas as origens anteriores do ID continuam a ter prioridade.

Regenerar o machine ID numa VPS clonada

A ordem é importante. systemd-machine-id-setup(1) verifica primeiro /run/machine-id, depois um machine ID D-Bus válido e, em seguida, a credencial system.machine_id, antes de tentar usar um UUID configurado da VM ou do contentor e, por fim, gerar um valor aleatório. Deixe um /var/lib/dbus/machine-id real no lugar e, a menos que /run/machine-id tenha prioridade, irá regenerar exatamente o valor que pretendia eliminar. Se a ferramenta reutilizar /run/machine-id ou uma credencial e o ID permanecer inalterado, limpe o machine ID da imagem enquanto ela estiver desligada e arranque-a com fontes de identidade ú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

É obrigatório truncar primeiro, porque a ferramenta só atua quando o ficheiro está ausente ou vazio. Não faz nada a um ficheiro que já contenha um ID válido. systemd-machine-id-setup comunica o que fez através da saída de erro padrão. Numa VPS KVM com systemd 258 ou posterior, quando seleciona o UUID do hypervisor, verá:

Initializing machine ID from SMBIOS/DMI UUID.

No systemd 255, o mesmo passo é apresentado como Initializing machine ID from VM UUID. Initializing machine ID from random generator. é a mensagem apresentada quando nenhuma fonte de ID anterior está disponível. Qualquer dos resultados é aceitável, desde que cat /etc/machine-id apresente agora um valor diferente do outro servidor.

O symlink mantém o D-Bus e o systemd a usar o mesmo valor. Se preferir um ficheiro real separado, execute sudo dbus-uuidgen --ensure em vez do comando do symlink: quando o ficheiro do D-Bus está ausente, copia o ID válido de /etc/machine-id. Se /var/lib/dbus estiver ausente, ln falha com No such file or directory, e pode ignorar ambas as linhas.

Em seguida, reinicie o sistema.

sudo reboot

Por que o reboot não é opcional

Todos os processos que já leram o valor antigo continuam a usá-lo. sd_id128_get_machine() armazena o ID por thread: uma thread que já o leu continua a devolver o valor antigo, e apenas uma thread que ainda não o consultou lê o ficheiro alterado. Assim, um daemon em execução pode manter o ID antigo nas threads existentes e obter o novo apenas nas threads que iniciar mais tarde. O journald já tem /var/log/journal/<old-id>/system.journal aberto e continua a acrescentar dados. O systemd-networkd calculou o seu DUID quando arrancou e continua a enviar o identificador de cliente antigo em cada renovação, que normalmente é exatamente a falha que pretendia corrigir. O D-Bus também leu o seu ID no arranque. Pode reiniciar os serviços um a um, mas algum ficará por reiniciar, e o PID 1 também mantém o valor antigo.

Depois do reboot, verifique as duas partes:

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

Com o registo persistente ativado, /var/log/journal/ contém agora um segundo diretório com o novo ID, e as entradas novas são gravadas nesse diretório. O journalctl simples lê apenas o diretório da máquina atual, por isso o histórico anterior ao clone desaparece da vista predefinida. Continua no disco: journalctl --merge lê todos os diretórios de journal, incluindo o antigo. Elimine o diretório antigo quando tiver a certeza de que já não precisa desses logs.

É também por isso que um contentor não é o local correto para ensaiar este procedimento. Um contentor partilha o kernel do host. Pode executar o systemd como o seu próprio PID 1, mas nunca arranca um kernel próprio. Dentro de um contentor, systemd-machine-id-setup usa um UUID de contentor configurado apenas depois de falharem as fontes de ID anteriores; sem uma fonte utilizável, gera um ID aleatório. Teste da forma como acontece em produção: clone uma VM, execute os comandos, faça reboot e compare o ID com o da máquina de origem.

Esvazie antes de criar o snapshot, não depois de clonar

Corrigir os clones um de cada vez funciona. Corrigir a imagem é melhor, porque todos os servidores restaurados a partir de um snapshot incorreto herdam o mesmo valor. Faça isto como a última operação antes de desligar o 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 now

Esvazie o ficheiro. Não o elimine. machine-id(5) recomenda um ficheiro vazio para imagens usadas em várias máquinas, porque um ficheiro vazio no local permite montar um ficheiro temporário por bind sobre o ficheiro real quando a imagem é usada em modo só de leitura. Num /etc só de leitura, o ID gerado no arranque fica nesse ficheiro temporário, e systemd-machine-id-setup --commit grava-o depois de o sistema de ficheiros ficar com permissões de escrita.

Um efeito secundário depende da forma como deixa o ficheiro. machine-id(5) especifica que, se /etc/machine-id existir e estiver vazio, o arranque não é considerado o primeiro arranque; por isso, o ficheiro vazio acima não ativa as unidades que tenham ConditionFirstBoot=yes. Um ficheiro ausente, ou um ficheiro que contenha a string uninitialized, faz com que o arranque seguinte seja considerado o primeiro arranque: essas unidades são executadas e o systemd também aplica predefinições às unidades. Consulte o que a sua imagem executaria com grep -rl ConditionFirstBoot /usr/lib/systemd/system/ antes de criar o template.

Um template e um snapshot são objetos diferentes, e essa diferença determina se a identidade é copiada. Um template é um artefacto de compilação que prepara deliberadamente, enquanto um snapshot é uma cópia pontual de um servidor em execução e transporta a identidade desse servidor juntamente com os respetivos dados.

Por que as imagens cloud acertam e o seu snapshot não

As imagens cloud das distribuições são preparadas para serem clonadas. Por isso, são distribuídas sem o machine ID preenchido, que é gerado no primeiro boot. O cloud-init tem uma etapa documentada especificamente para este caso. cloud-init clean --machine-id define /etc/machine-id como a string literal uninitialized em sistemas systemd. A referência da CLI do cloud-init descreve esta prática como recomendada ao clonar uma imagem golden. Assim, o próximo boot dessa imagem gera um machine ID único.

Um snapshot criado por si é diferente. O ficheiro já estava preenchido quando criou o snapshot. Por isso, todos os servidores restaurados a partir dele mantêm esse mesmo valor, a menos que o processo de restauro o limpe ou substitua explicitamente. Este é o mesmo tipo de problema que mover um servidor em execução para um novo VPS, em que a cópia é fiel, mas a identidade é precisamente a parte que não queria copiar.

O que mais um clone duplica

  • Chaves de host SSH. /etc/ssh/ssh_host_* também é copiado, por isso os dois servidores apresentam a mesma impressão digital aos clientes. Remova esses ficheiros e execute sudo ssh-keygen -A ou sudo dpkg-reconfigure openssh-server em Debian e Ubuntu. Os clientes irão avisar sobre a alteração da chave de host. Esse é o comportamento correto.
  • O nome de host. Defina-o com sudo hostnamectl set-hostname app02 e confirme depois que /etc/hosts ainda resolve o novo nome.
  • Configuração de rede estática. Um clone de um sistema com um endereço estático entra em conflito com o original assim que é iniciado. Consulte /etc/netplan/ antes de o clone se ligar à rede.
  • O relógio. Restaurar um snapshot que inclua memória em execução pode deixar o relógio do guest atrasado até que o guest ou o hypervisor o corrija. Um grande salto no relógio de um VPS restaurado interrompe a validação dos certificados TLS e altera a ordem dos logs até à sincronização da hora.

Siga também no clone a checklist dos primeiros dez minutos para um VPS novo. Um sistema clonado herda as contas de utilizador, as chaves SSH, as regras de firewall e os jobs agendados do sistema de origem. Nada disso foi revisto para a função que o clone está prestes a desempenhar.

FAQ

Tenho de fazer reboot depois de alterar /etc/machine-id?

Sim. O software que já leu o machine ID mantém a cópia em cache, por isso o novo valor não chega às partes relevantes de um sistema em execução. O journald continua a gravar no diretório de journal com o nome do ID antigo, e o cliente DHCP continua a enviar um identificador de cliente derivado do valor antigo, que normalmente é a razão para o ter alterado. Reiniciar serviços individuais corrige alguns deles, mas o PID 1 também mantém o valor antigo. Faça reboot e confirme com cat /etc/machine-id, comparando também com o outro servidor.

/etc/machine-id é igual ao UUID do hardware?

Não. O UUID do produto DMI em /sys/class/dmi/id/product_uuid vem do hypervisor e só pode ser lido por root. O machine ID é gerado pelo sistema operativo e fica num ficheiro simples que qualquer utilizador pode ler. A relação funciona apenas numa direção: num guest KVM, systemd-machine-id-setup usa o UUID do hypervisor como base para gerar um novo machine ID quando não se aplica nenhuma fonte de ID anterior. Se dois clones partilharem um UUID de produto e a regeneração o utilizar, irão gerar o mesmo machine ID. Por isso, compare também esse ficheiro antes de confiar no resultado.

Devo eliminar /etc/machine-id ou deixá-lo vazio?

Deixe-o vazio quando estiver a preparar uma imagem. machine-id(5) dá preferência a um ficheiro vazio, porque o systemd pode montar um ficheiro temporário sobre ele quando a imagem é executada com um /etc só de leitura. Eliminar o ficheiro funciona num sistema com escrita e alguns scripts de clone fazem isso, mas o ficheiro vazio é a opção predefinida mais segura. O cloud-init escreve a palavra uninitialized no ficheiro. Esse valor, tal como um ficheiro inexistente, faz com que o próximo boot seja tratado como o primeiro boot, por isso as unidades com ConditionFirstBoot=yes são executadas nesse boot. Um ficheiro vazio não produz esse efeito.

Por que razão os meus dois servidores clonados receberam o mesmo endereço DHCP?

Porque ambos enviaram o mesmo identificador de cliente. O systemd-networkd usa ClientIdentifier=duid por predefinição para DHCPv4, e o DUID predefinido é criado a partir de um hash de /etc/machine-id. Por isso, machine IDs idênticos produzem DUIDs predefinidos idênticos. Os identificadores de cliente completos só coincidem quando os IAIDs também coincidem: o systemd gera um IAID a partir de um nome persistente obtido do udev e usa o endereço MAC como alternativa quando não existe um nome previsível. A coincidência dos nomes atuais das interfaces, por si só, não garante isso. Quando os identificadores completos coincidem, o servidor DHCP faz a correspondência com base nesse identificador, trata ambos os pedidos como provenientes do mesmo cliente e atribui um único lease. Dê a cada máquina o seu próprio machine ID e faça reboot em ambas. Se o servidor continuar a oferecer o endereço antigo, limpe o lease obsoleto no próprio servidor DHCP.

Este artigo foi útil?

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