Configurar interfaces de red con netplan en Ubuntu, y probar cambios sin perder la conexión

Objetivo

Cambiar una IP estática, una ruta o una configuración de bonding en Ubuntu 22.04/24.04 mediante netplan sin arriesgarse a quedar bloqueado en una máquina remota.

Requisitos previos

Acceso root; saber qué renderizador está activo (networkd es el valor por defecto en Server, NetworkManager en Desktop); un tipo de sesión que sobreviva a una interrupción breve de la red (el acceso por consola es más seguro que SSH para el apply final).

Pasos

1. Localizar la configuración existente, normalmente un único archivo bajo /etc/netplan/*.yaml. La referencia YAML de netplan indica que la clave renderer nombra «la herramienta que se usará para configurar la red. Los valores válidos son networkd y NetworkManager», y por defecto es networkd cuando no se indica.
2. Editar o añadir un archivo con la configuración deseada, por ejemplo una dirección estática:

   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. Mantener los archivos YAML legibles solo por root (chmod 600 /etc/netplan/*.yaml); las versiones actuales de netplan advierten sobre archivos legibles por cualquiera porque pueden contener claves Wi-Fi y otros secretos. Validar la sintaxis sin aplicarla: netplan generate, que renderiza la configuración del backend en una ubicación temporal y falla de forma explícita ante un error de YAML o de esquema.
4. En cualquier sesión donde un error pudiera cortar la conectividad, usar netplan try en lugar de netplan apply directamente. netplan try «toma una configuración de netplan, la aplica y la revierte automáticamente si el usuario no confirma la configuración dentro de un tiempo límite» (120 segundos por defecto, modificable con --timeout).
5. Confirmar pulsando Intro dentro del tiempo límite; si la sesión ya se ha perdido, no hacer nada — la reversión automática restaura la configuración anterior.
6. Una vez confirmado, ejecutar netplan apply si se realizaron más ediciones, y verificar con ip addr show eth0 e ip route.

Resultado esperado

ip addr muestra la nueva dirección inmediatamente después de un netplan try/apply confirmado; una configuración incorrecta se revierte por sí sola dentro del tiempo límite y la conectividad vuelve sin necesidad de recuperación manual.

Límites y base de verificación

Algunas configuraciones (por ejemplo, puentes con STP habilitado) pueden tardar más de un minuto en estabilizarse, lo que la propia nota de problemas conocidos de la herramienta señala como un caso en el que el tiempo límite por defecto puede ser demasiado corto. No se requiere reinicio; puede ser necesario volver a iniciar sesión solo si el cambio alteró la interfaz usada por la sesión actual. La alternativa clásica de Debian, ifupdown, mantiene las definiciones de interfaz en /etc/network/interfaces en lugar de YAML, y se aplica con ifup/ifdown en lugar de un renderizador; no tiene un comando equivalente de probar y revertir, así que los cambios allí deben probarse directamente desde el acceso por consola.