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 executandogdcloud 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
- Eles precisam conter apenas caracteres alfanuméricos minúsculos ou
-e começar e terminar com um caractere alfanumérico.
- Eles precisam conter apenas caracteres alfanuméricos minúsculos ou
- 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 (
PUBLICouPRIVATE) 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,
dnsNamepara 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:
- 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.
- 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 /alle 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> 53Verifique 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 processomDNSResponder, forçando-o a recarregar e limpar o cache.
- O que ele faz: envia um sinal de desligamento (
- Linux (systemd-resolved):
sudo systemd-resolve --flush-cachesousudo resolvectl flush-caches- O que faz: instrui o serviço
systemd-resolveda descartar o cache DNS interno.
- O que faz: instrui o serviço
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.