Configurar interfaces de rede com netplan no Ubuntu e testar alterações sem perder a conexão

Objetivo

Alterar um IP estático, uma rota ou uma configuração de bonding no Ubuntu 22.04/24.04 por meio do netplan, sem o risco de perder o acesso a uma máquina remota.

Pré-requisitos

Acesso root; saber qual renderer está ativo (networkd é o padrão no Server e NetworkManager no Desktop); um tipo de sessão que sobreviva a uma breve interrupção da rede (para o apply final, o acesso por console é mais seguro do que SSH).

Passos

1. Localize a configuração existente, normalmente um arquivo em /etc/netplan/*.yaml. A referência YAML do netplan indica que a chave renderer define "the tool that will be used to set up your configuration. Valid values are networkd and NetworkManager" (a ferramenta usada para aplicar a configuração; os valores válidos são networkd e NetworkManager), sendo networkd o padrão quando ela não é definida.
2. Edite ou adicione um arquivo com as configurações desejadas, por exemplo um endereço estático:

   network:
     version: 2
     ethernets:
       eth0:
         addresses: [192.0.2.10/24]
         routes:
           - to: default
             via: 192.0.2.1
         nameservers:
           addresses: [192.0.2.1]
   

3. Mantenha os arquivos YAML legíveis apenas pelo root (chmod 600 /etc/netplan/*.yaml); as versões atuais do netplan emitem um aviso para arquivos legíveis por todos, pois eles podem conter chaves de Wi-Fi e outros segredos. Valide a sintaxe sem aplicar: netplan generate, que gera a configuração do backend em um local temporário e falha de forma explícita em caso de erro de YAML ou de esquema.
4. Em qualquer sessão em que um erro possa cortar a conectividade, use netplan try em vez de executar netplan apply diretamente. O netplan try "takes a netplan configuration, applies it, and automatically rolls it back if the user does not confirm the configuration within a time limit" (recebe uma configuração do netplan, aplica-a e a reverte automaticamente se o usuário não a confirmar dentro de um tempo limite). O padrão é 120 segundos, alterável com --timeout.
5. Confirme pressionando Enter dentro do tempo limite; se a sessão já tiver sido perdida, não faça nada: a reversão automática restaura a configuração anterior.
6. Depois de confirmar, execute netplan apply se tiver feito mais edições e verifique com ip addr show eth0 e ip route.

Resultado esperado

ip addr mostra o novo endereço logo após um netplan try/apply confirmado; uma configuração errada é revertida sozinha dentro do tempo limite e a conectividade volta sem recuperação manual.

Limites e base de verificação

Algumas configurações (pontes com STP ativado, por exemplo) podem levar mais de um minuto para estabilizar, o que a própria nota de problemas conhecidos da ferramenta aponta como um caso em que o tempo limite padrão pode ser curto demais. Não é necessário reiniciar; um novo login pode ser necessário apenas se a alteração mudar a interface usada na sessão atual. A alternativa clássica do Debian, o ifupdown, mantém as definições das interfaces em /etc/network/interfaces em vez de YAML, e as aplica com ifup/ifdown em vez de um renderer; ele não tem um comando equivalente de teste com reversão, então as alterações nele devem ser testadas diretamente a partir do acesso por console.