Solución de problemas de Cloud DNS

En este documento se ofrecen directrices para la solución de problemas de Cloud DNS en Google Distributed Cloud (GDC) aislado. Se incluyen los posibles errores y problemas que pueden surgir al realizar operaciones de gestión en las configuraciones de DNS, así como consejos y sugerencias para depurar problemas con la resolución de DNS. Este documento está dirigido a administradores de plataformas y operadores de aplicaciones responsables de gestionar los registros DNS de un proyecto.

Solucionar problemas de operaciones de gestión de Cloud DNS

En esta sección se proporciona información para solucionar problemas habituales que se producen al realizar operaciones de creación, lectura, actualización y eliminación (CRUD) en zonas y conjuntos de registros de Cloud DNS.

Solución de problemas básica

Nombres y validación de recursos (RFC 1123)

Problema: No se puede crear o actualizar debido a un argumento no válido o a errores de validación.

Detalles:

  • Nombres de recursos: los nombres de las zonas DNS y de los conjuntos de registros deben cumplir el estándar RFC.
    1. Solo deben contener caracteres alfanuméricos en minúscula o -, y deben empezar y terminar con un carácter alfanumérico.
  • Nombres de DNS: los valores de los nombres de dominio y de los nombres de dominio completos deben ser nombres de dominio válidos.
  • Valores de enumeración: los valores como la visibilidad (PUBLIC o PRIVATE) y los tipos de registro (por ejemplo, A o CNAME) distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con la cadena esperada.

No se pueden eliminar zonas que no estén vacías

Problema: No se puede eliminar una zona gestionada; la operación se rechaza.

Detalles: Para poder eliminar una zona DNS gestionada, no debe contener conjuntos de registros de recursos. Primero debes eliminar todos los registros de la zona.

Conflictos de nombres y dominios

Problema: No se puede crear un recurso y aparece un error que indica que el nombre o el dominio ya están en uso.

Detalles:

  • Nombre del recurso de Kubernetes: el nombre del objeto (por ejemplo, el nombre en metadata.name) debe ser único en el espacio de nombres del proyecto específico.
  • Nombre de DNS (FQDN): el nombre de dominio real (por ejemplo, dnsName para zonas o registros) debe ser único en una visibilidad determinada (PÚBLICA o PRIVADA). No puedes crear dos zonas ni dos registros con el mismo nombre de dominio en el mismo nivel de visibilidad.

Solucionar problemas de resolución de DNS

Esta sección ayuda a los administradores de plataformas y a los operadores de aplicaciones a solucionar problemas de resolución de DNS al acceder a servicios alojados en Google Distributed Cloud.

Espera a que se propague y borra la caché de DNS

Cuando se crean o actualizan registros DNS, es posible que los cambios no se reflejen de inmediato. Este retraso suele deberse a lo siguiente:

  1. Tiempo de conciliación: el sistema necesita tiempo para procesar la solicitud y actualizar la configuración del servidor DNS. Este proceso suele tardar unos minutos.
  2. Retraso de propagación de DNS (almacenamiento en caché): las resoluciones de DNS y los clientes almacenan en caché los registros para acelerar las búsquedas. Es posible que los clientes sigan usando el registro antiguo hasta que haya transcurrido el periodo de tiempo de vida (TTL).

Recomendaciones:

  • Espera: deja tiempo suficiente para que se concilien los datos y caduque la caché.
  • Vaciar la caché: borra la caché de DNS local para forzar una nueva búsqueda.

Verificar la configuración del resolver local

Asegúrate de que tu cliente esté usando los servidores DNS correctos. Si no sabes cuál es la dirección IP correcta, ponte en contacto con tu equipo de operaciones de infraestructura (IO) para encontrar la dirección IP del servidor DNS correcta.

  • Linux/macOS: comprueba el contenido de /etc/resolv.conf.
  • Windows: ejecuta ipconfig /all y comprueba los servidores DNS que aparecen.

Las estaciones de trabajo de los administradores de plataformas (PAs) y los operadores de aplicaciones (AOs) de la red del cliente deben usar una resolución de DNS independiente de la red de la WAN de IO y de OIRv2. Como los nombres de dominio de GDC idénticos se resuelven en direcciones IP diferentes en función de si la consulta llega a través de la WAN de IO o de la interconexión del cliente, no es posible usar una configuración de DNS compartida para las estaciones de trabajo de IO y de PA o AO. Para obtener más información, consulta Interconexiones del sistema, Esquema de nombres de dominio DNS y el runbook DNS-R0016.

Probar la resolución con herramientas estándar

Usa herramientas de línea de comandos estándar para probar la resolución e identificar dónde se produce el fallo.

  • Búsqueda básica:

    dig <domain_name>
    

    o

    nslookup <domain_name>
    
  • Consultar un servidor DNS específico: Si conoces la IP del servidor público de ManagedDNS, consúltalo directamente para evitar los resolutores locales:

    dig @<public_dns_server_ip> <domain_name>
    
  • Consultar un servidor de nombres público: Para descartar problemas con el resolver local, prueba a consultar un resolver público como Google DNS:

    dig @8.8.8.8 <domain_name>
    

Analizar los códigos de respuesta de DNS

Cuando uses dig o nslookup, comprueba el código de estado de la respuesta:

  • NXDOMAIN no se ha encontrado el nombre de dominio. Comprueba si hay errores tipográficos o si el registro existe.
  • SERVFAIL: el servidor no ha podido procesar la consulta. Esto suele indicar un problema en el servidor o un fallo de comunicación entre los servidores DNS.
  • NOERROR la consulta se ha realizado correctamente, pero puede que no haya respuestas. Verifica si existe el tipo de registro solicitado (por ejemplo, A o CNAME).
  • REFUSED: el servidor ha rechazado responder a la consulta, probablemente debido a la configuración de la política o del control de acceso.

Comprueba tu conexión de red

Asegúrate de que el tráfico de red al servidor DNS no esté bloqueado.

  • El DNS usa el puerto 53 tanto para UDP como para TCP.
  • Prueba la conectividad con nc (netcat):

    nc -zv <dns_server_ip> 53
    
  • Comprueba que las reglas de cortafuegos permitan el tráfico en el puerto 53.

Vaciar la caché de DNS

Al vaciar la caché de DNS, se eliminan todas las entradas de la caché de DNS local. De esta forma, se obliga al sistema operativo a volver a consultar los servidores DNS para obtener el nombre de dominio, lo que garantiza que obtengas el registro más actualizado en lugar de uno obsoleto almacenado en caché.

  • Windows: ipconfig /flushdns
    • Qué hace: borra la caché de resolución de DNS que mantiene el servicio de cliente DNS.
  • macOS: sudo killall -HUP mDNSResponder
    • Qué hace: envía una señal de desconexión (HUP) al proceso mDNSResponder, lo que obliga a recargar y borrar la caché.
  • Linux (systemd-resolved): sudo systemd-resolve --flush-caches o sudo resolvectl flush-caches
    • Qué hace: indica al servicio systemd-resolved que descarte su caché de DNS interna.

Comprobar el estado de los recursos con la API o con gdcloud

Si eres un cliente o tienes acceso a la API de GDC, puedes comprobar el estado de los recursos directamente:

  • Comprobar una zona DNS:

    kubectl describe manageddnszone <zone_name> -n <project_namespace>
    
  • Comprobar un conjunto de registros de recursos:

    kubectl describe resourcerecordset <record_name> -n <project_namespace>
    

    Busca condiciones y eventos que puedan indicar fallos en el proceso de conciliación.

Si tienes acceso a la línea de comandos de gdcloud, puedes usar el subcomando describe, tal como se indica en Mostrar registros DNS o Mostrar zonas DNS.