Resolver problemas do Cloud DNS

Este documento fornece orientações sobre como resolver problemas com o Cloud DNS no Google Distributed Cloud (GDC) com isolamento físico. Ele aborda possíveis erros e problemas que você pode encontrar ao realizar operações de gerenciamento em configurações de DNS e fornece dicas e sugestões para depurar problemas com a resolução de DNS. O público-alvo deste documento são administradores de plataforma e operadores de aplicativos responsáveis por gerenciar registros DNS em um projeto.

Resolver problemas de operações de gerenciamento do Cloud DNS

Nesta seção, apresentamos informações sobre a solução de problemas comuns encontrados ao realizar operações de criação, leitura, atualização e exclusão (CRUD, na sigla em inglês) em zonas de DNS e conjuntos de registros do Cloud DNS.

Solução de problemas básicos

  • Verifique se você tem os papéis corretos do IAM, conforme descrito em Preparar permissões do IAM.
  • Se estiver usando gdcloud, atualize o token de autenticação executando gdcloud auth login.

Nomeação e validação de recursos (RFC 1123)

Problema: falha na criação ou atualização com argumento inválido ou erros de validação.

Detalhes:

  • Nomes de recursos: os nomes das zonas de DNS e dos conjuntos de registros precisam estar em conformidade com a RFC
    1. Eles precisam conter apenas caracteres alfanuméricos minúsculos ou - e começar e terminar com um caractere alfanumérico.
  • Nomes DNS: os valores para nomes de domínio e nomes de domínio totalmente qualificados (FQDNs) precisam ser nomes de domínio válidos.
  • Valores de tipo enumerado: valores como visibilidade (PUBLIC ou PRIVATE) e tipos de registro (por exemplo, A, CNAME) diferenciam maiúsculas de minúsculas e precisam corresponder exatamente à string esperada.

Não é possível excluir zonas que não estão vazias

Problema: não é possível excluir uma zona gerenciada. A operação é rejeitada.

Detalhes: uma zona de DNS gerenciada precisa estar vazia de conjuntos de registros de recursos antes de ser excluída. Primeiro, exclua todos os registros dentro da zona.

Conflitos de nomenclatura e domínio

Problema: falha ao criar um recurso com um erro indicando que o nome ou domínio já está em uso.

Detalhes:

  • Nome do recurso do Kubernetes: o nome do objeto (por exemplo, o nome em metadata.name) precisa ser exclusivo no namespace do projeto específico.
  • Nome DNS (FQDN): o nome de domínio real (por exemplo, dnsName para zonas ou registros) precisa ser exclusivo em uma determinada visibilidade (PÚBLICA ou PRIVADA). Não é possível criar duas zonas ou dois registros com o mesmo nome de domínio no mesmo nível de visibilidade.

Resolver problemas de resolução de DNS

Nesta seção, ajudamos administradores de plataforma e operadores de aplicativos a resolver problemas de resolução de DNS ao acessar serviços hospedados no Google Distributed Cloud.

Aguardar a propagação e limpar o cache de DNS

Quando os registros DNS são criados ou atualizados, as mudanças podem não ficar visíveis instantaneamente. Esse atraso geralmente é causado por:

  1. Tempo de reconciliação: o sistema precisa de tempo para processar a solicitação e atualizar a configuração do servidor DNS. Isso normalmente leva alguns minutos.
  2. Atraso na propagação de DNS (armazenamento em cache): os resolvedores de DNS e os clientes armazenam registros em cache para acelerar as pesquisas. Os clientes podem continuar usando o registro antigo até que o período de vida útil (TTL) tenha passado.

Recomendações:

  • Aguarde: aguarde tempo suficiente para a reconciliação e a expiração do cache.
  • Limpar cache: limpe o cache de DNS local para forçar uma nova pesquisa.

Verificar a configuração do resolvedor local

Verifique se o cliente está usando os servidores DNS corretos. Se você não souber o endereço IP correto, entre em contato com a equipe de operações de infraestrutura (IO, na sigla em inglês) para encontrar o IP do servidor DNS correto.

  • Linux/macOS: verifique o conteúdo de /etc/resolv.conf.
  • Windows: execute ipconfig /all e verifique os servidores DNS listados.

As estações de trabalho do administrador da plataforma (PA) e do operador de aplicativos (AO) na rede do cliente precisam usar uma resolução de DNS separada da WAN de IO e da rede OIRv2. Como nomes de domínio idênticos do GDC são resolvidos para endereços IP diferentes, dependendo se a consulta chega pela WAN de IO ou pela interconexão do cliente, não é possível usar uma configuração de DNS compartilhada para estações de trabalho de IO e PA ou AO. Para mais informações, consulte Interconexões do sistema, Esquema de nomenclatura de nome de domínio DNS e o runbook DNS-R0016.

Testar a resolução usando ferramentas padrão

Use ferramentas de linha de comando padrão para testar a resolução e identificar onde ocorre a falha.

  • Pesquisa básica:

    dig <domain_name>
    

    ou

    nslookup <domain_name>
    
  • Consultar um servidor DNS específico: se você souber o IP do servidor público do ManagedDNS, consulte-o diretamente para ignorar os resolvedores locais:

    dig @<public_dns_server_ip> <domain_name>
    
  • Consulte um servidor de nomes público: para descartar problemas de resolvedor local, tente consultar um resolvedor público, como o DNS do Google:

    dig @8.8.8.8 <domain_name>
    

Analisar códigos de resposta DNS

Ao usar dig ou nslookup, verifique o código de status na resposta:

  • NXDOMAIN: o nome de domínio não foi encontrado. Verifique se há erros de digitação ou se o registro existe.
  • SERVFAIL: o servidor não conseguiu processar a consulta. Isso geralmente indica um problema no servidor ou uma falha de comunicação entre servidores DNS.
  • NOERROR: a consulta foi bem-sucedida, mas pode não haver respostas. Verifique se o tipo de registro solicitado (por exemplo, A, CNAME) existe.
  • REFUSED: o servidor se recusou a responder à consulta, provavelmente devido a configurações de política ou controle de acesso.

Verifique a conectividade da rede

Verifique se o tráfego de rede para o servidor DNS não está bloqueado.

  • O DNS usa a porta 53 para UDP e TCP.
  • Teste a conectividade usando nc (netcat):

    nc -zv <dns_server_ip> 53
    
  • Verifique se as regras de firewall permitem o tráfego na porta 53.

Limpar o cache do DNS

A limpeza do cache de DNS remove todas as entradas do cache de DNS local. Isso força o sistema operacional a consultar os servidores DNS novamente para o nome de domínio, garantindo que você receba o registro mais atualizado em vez de um registro em cache desatualizado.

  • Windows: ipconfig /flushdns
    • O que faz: limpa o cache do resolvedor de DNS mantido pelo serviço do cliente DNS.
  • macOS: sudo killall -HUP mDNSResponder
    • O que ele faz: envia um sinal de desligamento (HUP) para o processo mDNSResponder, forçando-o a recarregar e limpar o cache.
  • Linux (systemd-resolved): sudo systemd-resolve --flush-caches ou sudo resolvectl flush-caches
    • O que faz: instrui o serviço systemd-resolved a descartar o cache DNS interno.

Verificar o status do recurso com a API ou gdcloud

Se você for um locatário ou tiver acesso à API GDC, poderá verificar o status dos recursos diretamente:

  • Verifique uma zona de DNS:

    kubectl describe manageddnszone <zone_name> -n <project_namespace>
    
  • Verificar um conjunto de registros de recursos:

    kubectl describe resourcerecordset <record_name> -n <project_namespace>
    

    Procure condições e eventos que possam indicar falhas no processo de reconciliação.

Se você tiver acesso à linha de comando gdcloud, use o subcomando describe, conforme documentado em Listar registros DNS ou Listar zonas de DNS.