Esta página descreve como configurar políticas de roteamento de DNS e ativar as verificações de integridade usando o Cloud DNS. Antes de usar esta página, familiarize-se com as políticas de roteamento de DNS e as verificações de integridade.
Antes de começar
Para configurar políticas de roteamento de DNS, crie um conjunto de registros de recursos e escolha uma das seguintes políticas de roteamento de DNS para aplicar ao conjunto de registros de recursos.
As políticas de roteamento de DNS oferecem suporte a vários endereços IP por localização geográfica na política de roteamento de geolocalização. Quando você especifica vários endereços IP para uma localização geográfica, o Cloud DNS retorna todos os endereços IP especificados para essa localização. Não é possível combinar uma política de roteamento de geolocalização com uma política de WRR de ponderação personalizada.
Aplique apenas um tipo de política de roteamento a um conjunto de registros de recurso por vez.
Ative o acesso global para balanceadores de carga regionais.
Antes de configurar políticas de roteamento de DNS para zonas públicas, desative a restrição da política da organização
constraints/compute.disableInternetNetworkEndpointGroup
. Para mais informações, consulte Restrições da política da organização.Verifique se você tem as permissões necessárias para configurar políticas de roteamento de DNS.
Criar políticas de roteamento de DNS para zonas particulares
Antes de criar políticas de roteamento de DNS para zonas particulares, siga as etapas abaixo.
- Criar uma zona particular.
- Configurado um dos seguintes balanceadores de carga internos:
- Crie regras de encaminhamento para o balanceador de carga interno.
- Configure a verificação de integridade do balanceador de carga interno.
Para criar políticas de roteamento de DNS para zonas particulares, siga estas etapas.
Console
Inicie a configuração
No Trusted Cloud console, acesse a página Zonas do Cloud DNS.
Clique no nome da zona gerenciada a que você quer adicionar o registro.
Na página Detalhes da zona, clique em Adicionar com a política de roteamento.
Dados base
Opcional: na página Criar conjunto de registros com política de roteamento, em Nome do DNS, insira um subdomínio do nome do DNS, por exemplo,
mail
. O ponto é adicionado automaticamente.Em Tipo de registro de recurso, selecione uma opção.
Em TTL, insira um valor numérico para o time to live (TTL) do registro de recurso, que é o tempo que ele pode ser armazenado em cache. O valor precisa ser um número inteiro positivo.
Opcional: em Unidade TTL, selecione a unidade de tempo. Por exemplo,
minutes
. O padrão é definido comominutes
.Clique em Próxima.
Tipo de política de roteamento
- Em Política de roteamento, selecione Round-robin ponderado, Geolocalização ou Failover.
- Clique em Próxima.
Dados da política de roteamento
WRR
Em Peso, insira o peso correspondente a essa subseção dos dados do registro de recurso (RR).
Essa ponderação precisa ser um número não negativo de 0,0 a 1.000,0. A proporção de tráfego roteado para o destino é calculada a partir da proporção da ponderação individual sobre o total em todas as ponderações. Por exemplo, se o destino A tiver uma ponderação de 25 e o destino B tiver uma ponderação de 75, com um peso total de 100, o Cloud DNS encaminha 25/100 = 0,25 (25 por cento) do tráfego total para o destino A e 75/100= 0,75 (75 por cento) para o destino B.
Na seção Destinos de verificação de integridade IPv4, faça o seguinte:
- Em Projeto, selecione o projeto em que a regra de encaminhamento existe.
Em Regra de encaminhamento, selecione uma regra.
A regra de encaminhamento especifica um endereço IP interno, uma porta e uma das seguintes opções:
- Um serviço de back-end regional
- Um proxy HTTPS de destino global ou regional
- Um proxy TCP de destino regional
Clique em Concluído.
Opcional: para adicionar outro destino verificado de integridade, clique em Adicionar destino.
Opcional: para permitir endereços IPv4 sem verificação de integridade, faça o seguinte:
- Selecione Permitir endereços IPv4 sem verificação de integridade.
- Em Endereço IPv4, insira um endereço IPv4.
Opcional: para adicionar outro conjunto de dados de roteamento da política de WRR, clique em Adicionar dados de roteamento.
Clique em Próxima.
Geolocalização
Em Cercas geográficas, selecione Desativada ou Ativada.
Ativar a fronteira geográfica virtual restringe o tráfego a uma geolocalização específica, mesmo que todos os endpoints dela estejam não íntegros.
Em Região de origem, selecione uma região de origem Trusted Cloudválida.
Na seção Destinos de verificação de integridade IPv4, faça o seguinte:
- Em Projeto, selecione o projeto em que a regra de encaminhamento existe.
Em Regra de encaminhamento, selecione uma regra.
A regra de encaminhamento especifica um endereço IP interno, uma porta e uma das seguintes metas:
- Um serviço de back-end regional
- Um proxy HTTPS de destino global ou regional
- Um proxy TCP de destino regional
Clique em Concluído.
Opcional: para adicionar outro destino verificado de integridade, clique em Adicionar destino.
Opcional: para permitir endereços IPv4 sem verificação de integridade, faça o seguinte:
- Selecione Permitir endereços IPv4 sem verificação de integridade.
- Em Endereço IPv4, insira um endereço IPv4.
Opcional: para adicionar um conjunto de dados de roteamento de outra política de geolocalização, clique em Adicionar dados de roteamento.
Clique em Próxima.
Failover
Na seção Destinos principais verificados quanto à integridade, faça o seguinte:
- Em Projeto, selecione o projeto em que a regra de encaminhamento existe.
Em Regra de encaminhamento, selecione uma regra.
A regra de encaminhamento especifica um endereço IP interno, uma porta e uma das seguintes opções:
- Um serviço de back-end regional
- Um proxy HTTPS de destino global ou regional
- Um proxy TCP de destino regional
Na seção Política de geolocalização de backup, faça o seguinte:
- Em Cercas geográficas, selecione Desativada ou Ativada. Ativar a fronteira geográfica virtual restringe o tráfego a uma geolocalização específica, mesmo que todos os endpoints dela estejam não íntegros.
- Em Região de origem, selecione uma região de origem Trusted Cloudválida.
Na seção Destinos de verificação de integridade IPv4, faça o seguinte:
- Em Projeto, selecione o projeto em que a regra de encaminhamento existe.
Em Regra de encaminhamento, selecione uma regra.
A regra de encaminhamento especifica uma das seguintes opções:
- Um endereço IP interno, uma porta e um serviço de back-end regional
- Um proxy HTTP(S)
- Um proxy TCP
Quando nenhum dos endereços IP primários estiver íntegro, o tráfego será processado automaticamente de acordo com a política de geolocalização de backup.
Clique em Concluído.
Opcional: para adicionar outro destino verificado de integridade, clique em Adicionar destino.
Opcional: para permitir endereços IPv4 sem verificação de integridade, faça o seguinte:
- Selecione Permitir endereços IPv4 sem verificação de integridade.
- Em Endereço IPv4, insira um endereço IPv4.
Opcional: para adicionar outro conjunto de dados de roteamento da política de geolocalização de backup, clique em Adicionar dados de roteamento.
No campo Trickle traffic (%), insira a porcentagem do tráfego enviado aos destinos de failover, independentemente do status da verificação de integridade dos destinos principais.
Clique em Próxima.
Revisar e criar
- Clique em Revisar.
- Revise seu conjunto de registros do Cloud DNS com a configuração da política de roteamento.
- Clique em Criar.
gcloud
Para um conjunto de registros de recurso, você define uma política de roteamento (routingPolicy
)
ou dados de DNS (rrdatas
), não ambos. Para alternar entre uma política de roteamento e
dados DNS, atualize o conjunto de registros de recurso. Por exemplo, para mudar um conjunto de registros de recurso
que contém dados de DNS (rrdatas
) para conter uma
política de roteamento (routingPolicy
), exclua rrdatas
e adicione routingPolicy
ao mesmo conjunto de registros de recurso.
Para criar políticas de roteamento de DNS para zonas particulares, siga estas etapas.
Execute o gcloud dns record-sets create
comando:
WRR
gcloud dns record-sets create RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=WRR \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-health-checking
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo,service.example.com
.TTL
: o TTL, em segundos, em que o resolvedor armazena em cacheResourceRecordSet
, como30
.RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
. Para uma lista de tipos de registro com suporte, consulte Tipos de registro com suporte para políticas de roteamento de DNS.MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
. O nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixo.ROUTING_POLICY_DATA
: insira uma lista delimitada por ponto e vírgula no formato${weight_percent}:${rrdatas}
, como.8=203.0.113.1;.2=198.51.100.1
. Especifique a ponderação como um decimal não negativo. A proporção de tráfego roteado para o destino é calculada a partir da proporção da ponderação individual sobre o total em todas as ponderações. Os nomes das regras de encaminhamento são valores aceitáveis e resultam em verificação de integridade.--enable-health-checking
: a sinalização para ativar a verificação de integridade. Ao usar essa sinalização, é necessário fornecer o nome da regra de encaminhamento em vez do endereço IP no campo--routing-policy-data
.
Geolocalização
gcloud dns record-sets create RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=GEO \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-health-checking
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo,service.example.com
.TTL
: o TTL, em segundos, em que o resolvedor armazena em cacheResourceRecordSet
, como30
.RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
. Para uma lista de tipos de registro com suporte, consulte Tipos de registro com suporte para políticas de roteamento de DNS.MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
. O nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixo.ROUTING_POLICY_DATA
: insira uma lista delimitada por ponto e vírgula no formato${region}=${IP_address}
, comoasia-east1=198.51.100.1;us-central1=203.0.113.1
. É possível especificar vários endereços IP para uma única região adicionando endereços IP separados por vírgula. Os nomes das regras de encaminhamento são valores aceitáveis e resultam em verificação de integridade.--enable-health-checking
: a sinalização para ativar a verificação de integridade. Ao usar essa sinalização, é necessário fornecer o nome da regra de encaminhamento em vez do endereço IP no campo--routing-policy-data
.
Geolocalização com fronteira geográfica virtual
gcloud dns record-sets create RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=GEO \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-geo-fencing \ --enable-health-checking
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo,service.example.com
.TTL
: o TTL, em segundos, em que o resolvedor armazena em cacheResourceRecordSet
, como30
.RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
. Para uma lista de tipos de registro com suporte, consulte Tipos de registro com suporte para políticas de roteamento de DNS.MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
. O nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixo.ROUTING_POLICY_DATA
: insira uma lista delimitada por ponto e vírgula no formato${region}=${IP_address}
, comoasia-east1=198.51.100.1;us-central1=203.0.113.1
. É possível especificar vários endereços IP para uma única região adicionando endereços IP separados por vírgula. Os nomes das regras de encaminhamento são valores aceitáveis e resultam em verificação de integridade.--enable-geo-fencing
: para políticas de roteamento deGEO
, isso determina se o tráfego deve fazer failover entre as regiões se todos os endpoints de uma região não estiverem íntegros. Quando definido, o Cloud DNS sempre direciona as consultas para a região mais próxima, mesmo que todos os endpoints dessa região não estejam íntegros. Use--no-enable-geo-fencing
para desativar a fronteira geográfica virtual. Quando não definido, o Cloud DNS direciona as consultas para a próxima região mais próxima quando todos os endpoints de uma região não estiverem íntegros. O padrão éfalse
.--enable-health-checking
: a sinalização para ativar a verificação de integridade. Ao usar essa sinalização, é necessário fornecer o nome da regra de encaminhamento em vez do endereço IP no campo--routing-policy-data
.
Failover
gcloud dns record-sets create RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=FAILOVER \ --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA \ --routing-policy-backup-data-type=ROUTING_POLICY_BACKUP_DATA_TYPE \ --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA \ --backup-data-trickle-ratio=BACKUP_DATA_TRICKLE_RATIO \ --enable-geo-fencing \ --enable-health-checking
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo,service.example.com
.TTL
: o TTL, em segundos, em que o resolvedor armazena em cacheResourceRecordSet
, como30
.RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
. Para uma lista de tipos de registro com suporte, consulte Tipos de registro com suporte para políticas de roteamento de DNS.MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
. O nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixo.ROUTING_POLICY_PRIMARY_DATA
: o destino principal a ser usado para políticas de roteamentoFAILOVER
. Esse destino precisa ser uma referência a uma ou mais regras de encaminhamento, comoforwarding-rule-1
. Contanto que pelo menos uma dessas regras de encaminhamento esteja íntegra, os endereços IP de todas as regras de encaminhamento íntegras serão usados para responder às consultas desse nome.ROUTING_POLICY_BACKUP_DATA_TYPE
: para as políticas de roteamentoFAILOVER
, o tipo de política de roteamento usado pelos dados de backup. Elas devem serGEO
.ROUTING_POLICY_BACKUP_DATA
: o destino de backup a ser usado para as políticas de roteamento deFAILOVER
. Esses destinos são usados quando todas as regras de encaminhamento especificadas em--routing-policy-primary-data
não estão íntegras. O Cloud DNS só é compatível com destinos de backup baseados em localização geográfica. O formato desse campo corresponde ao de--routing-policy-data
quando--routing-policy-type = 'GEO'
, comoasia-east1=forwarding-rule-2
.BACKUP_DATA_TRICKLE_RATIO
: a proporção de tráfego a ser enviada aos destinos de backup, mesmo quando as primárias estão íntegras. A proporção precisa estar entre 0 e 1, como0.1
. O padrão é definido como0
.--enable-geo-fencing
: para políticas de roteamento deGEO
, isso determina se o tráfego deve fazer failover entre as regiões se todos os endpoints de uma região não estiverem íntegros. Quando definido, o Cloud DNS sempre direciona as consultas para a região mais próxima, mesmo que todos os endpoints dessa região não estejam íntegros. Use--no-enable-geo-fencing
para desativar a fronteira geográfica virtual. Quando não definido, o Cloud DNS direciona as consultas para a próxima região mais próxima quando todos os endpoints de uma região não estiverem íntegros. O padrão éfalse
.--enable-health-checking
: a sinalização para ativar a verificação de integridade. Ao usar essa sinalização, é necessário fornecer o nome da regra de encaminhamento em vez do endereço IP no campo--routing-policy-data
.
API
Use o método resourceRecordSets.create
.
WRR
POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets { "name": "RRSET_NAME", "type": "RRSET_TYPE", "ttl": TTL, "routingPolicy": { "wrr": { "items": [ { "weight": WEIGHT, "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCER_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT_ID" "region": "REGION" } ] } }, { "weight": WEIGHT, "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCER_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT_ID" "region": "REGION" } ] } }, ] } } }
Substitua:
PROJECT_ID
: o ID do projetoMANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoRRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.TTL
: o TTL, em segundos, em que o resolvedor armazena essaResourceRecordSet
em cache, como30
WEIGHT
: para políticasWRR
, uma lista delimitada por ponto e vírgula no formato${weight_percent}=${rrdatas}
, como.8=10.128.1.1;.2=10.130.1.1
especifique o peso como qualquer decimal não negativo Observação: é preciso especificar o peso como um número não negativo. A proporção de tráfego roteado para o destino é calculada a partir da proporção da ponderação individual sobre o total em todas as ponderações.LOAD_BALANCER_TYPE
: o tipo de balanceador de carga, comoregionalL4ilb
,globalL7ilb
ouregionalL7ilb
. Essa configuração é opcional.IP_ADDRESS
: o endereço IP que a regra de encaminhamento veicula.PORT_NUMBER
: o número da portaIP_PROTOCOL
: define o protocolo usado para a verificação de integridade. as opções válidas sãotcp
eudp
NETWORK_URL
: o URL da rede a que esta regra de encaminhamento se aplica.REGION
: a região em que você criou a regra de encaminhamento
Geolocalização
POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets { "name": "RRSET_NAME", "type": "RRSET_TYPE", "ttl": TTL, "routingPolicy": { "geo": { "items": [ { "location": "LOCATION", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCER_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT_ID" "region": "REGION" } ] } }, { "location": "LOCATION", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCING_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT_ID" "region": "REGION" } ] } }, } ] } } }
Substitua:
PROJECT_ID
: o ID do projetoMANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoRRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.TTL
: o TTL, em segundos, em que o resolvedor armazena essaResourceRecordSet
em cache, como30
LOCATION
: para políticas deGEO
, a geolocalização para que você precisa criar a política, comoasia-east1
LOAD_BALANCER_TYPE
: o tipo de balanceador de carga, comoregionalL4ilb
,globalL7ilb
ouregionalL7ilb
. Essa configuração é opcional.IP_ADDRESS
: o endereço IP que a regra de encaminhamento veicula.PORT_NUMBER
: o número da porta do balanceador de carga internoIP_PROTOCOL
: define o protocolo usado para a verificação de integridade. as opções válidas sãotcp
eudp
NETWORK_URL
: o URL da rede a que esta regra de encaminhamento se aplica.REGION
: a região em que você criou a regra de encaminhamento
Failover
Na opção de failover, o Cloud DNS só é compatível com políticas GEO
.
POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets { "name": "RRSET_NAME", "type": "RRSET_TYPE", "ttl": TTL, "routingPolicy": { "primaryBackup": { "trickleTraffic": TRICKLE_TRAFFIC, "primaryTargets": { "internalLoadBalancers": [ { "ipAddress": "IP_ADDRESS" "ipProtocol": "IP_PROTOCOL" "loadBalancerType": "LOAD_BALANCER_TYPE" "networkUrl": "NETWORK_URL" "port": "PORT_NUMBER" "project": "PROJECT_ID" "region": "REGION" } ] }, "backupGeoTargets": { "enableFencing": ENABLE_FENCING, "items": [ { "location": "LOCATION", "rrdatas": [ "RRDATA" ] }, { "location": "LOCATION", "rrdatas": [ "RRDATA" ] } ] } }, } }
Substitua:
PROJECT_ID
: o ID do projetoMANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoRRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.TTL
: o TTL, em segundos, em que o resolvedor armazena essaResourceRecordSet
em cache, como30
TRICKLE_TRAFFIC
: a proporção de tráfego a ser enviada aos destinos de backup, mesmo quando as primárias estiverem íntegras; a proporção precisa estar entre 0 e 1, como0.1
.IP_ADDRESS
: o endereço IP que a regra de encaminhamento veicula.PORT_NUMBER
: o número da portaIP_PROTOCOL
: define o protocolo usado para a verificação de integridade. as opções válidas sãotcp
eudp
NETWORK_URL
: o URL da rede a que esta regra de encaminhamento se aplica.PORT_NUMBER
: o número da porta do balanceador de carga internoREGION
: a região em que você criou a regra de encaminhamentoENABLE_FENCING
: para políticas de roteamento deGEO
, isso determina se o tráfego deve fazer failover entre regiões se todos os endpoints de uma região não estiverem íntegros. Quando definido, o Cloud DNS sempre direciona as consultas para a região mais próxima, mesmo que todos os endpoints dessa região não estejam íntegros. Quando não definido, o Cloud DNS direciona as consultas para a região mais próxima quando todos os endpoints de uma região não estiverem íntegros. O padrão éfalse
.LOCATION
: para políticas deGEO
, a geolocalização para que você precisa criar a política, comoasia-east1
WEIGHT
: para políticasWRR
, uma lista delimitada por ponto e vírgula no formato${weight_percent}=${rrdatas}
, como.8=10.128.1.1;.2=10.130.1.1
especifique o peso como qualquer decimal não negativoRRDATA
: um valor arbitrário associado ao conjunto de registros de recursos, como198.51.100.5
; também é possível inserir vários valores,rrdata1
rrdata2
rrdata3
, como198.51.100.1
203.0.113.1
...
Atualizar políticas de roteamento de DNS
Para atualizar a política de roteamento de um conjunto de registros de recursos, siga estas etapas.
Console
No Trusted Cloud console, acesse a página Zonas do Cloud DNS.
Clique na zona em que você quer atualizar a política de roteamento do conjunto de registros de recursos.
Na página Detalhes da zona, ao lado do conjunto de registros de recursos que você quer atualizar, clique em editEditar.
Depois de fazer as atualizações, clique em Salvar.
gcloud
Execute o gcloud dns record-sets update
comando:
WRR
gcloud dns record-sets update RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=WRR \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-health-checking
Geolocalização
gcloud dns record-sets update RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=GEO \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-health-checking
Geolocalização com fronteira geográfica virtual
gcloud dns record-sets update RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=GEO \ --routing-policy-data=ROUTING_POLICY_DATA \ --enable-geo-fencing --enable-health-checking
Failover
gcloud dns record-sets update RRSET_NAME \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \ --routing-policy-type=FAILOVER \ --enable-geo-fencing \ --routing-policy-primary-data=ROUTING_POLICY_PRIMARY_DATA \ --routing-policy-backup-data=ROUTING_POLICY_BACKUP_DATA \ --backup-data-trickle-ratio=BACKUP_DATA_TRICKLE_RATIO \ --enable-health-checking
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
TTL
: o TTL em segundos em que o resolvedor armazena essaResourceRecordSet
em cache, como30
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.Para ver uma lista de tipos de registro compatíveis, consulte Selecionar tipos de registro de recurso.
MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoROUTING_POLICY_TYPE
: o tipo de política de roteamento.Digite
WRR
para o round-robin ponderado,GEO
para localização geográfica ouFAILOVER
para políticas de failover. Não é possível modificar esse campo depois que uma política tem um tipo escolhido. Você só pode excluir a política e adicionar uma nova com o tipo diferente.ROUTING_POLICY_DATA
: os dados da política de roteamento- Para
--routing-policy-type=WRR
, insira uma lista delimitada por ponto e vírgula do formato${weight_percent}:${rrdatas}
, como.8=203.0.113.1;.2=198.51.100.1
. Especifique a ponderação como um decimal não negativo. A proporção de tráfego roteado para o destino é calculada a partir da proporção da ponderação individual sobre o total em todas as ponderações. Os nomes das regras de encaminhamento são valores aceitáveis e resultam em verificação de integridade. - Para
--routing-policy-type=GEO
, insira uma lista delimitada por ponto e vírgula do formato${region}=${IP_address}
, comoasia-east1=198.51.100.1;us-central1=203.0.113.1
. É possível especificar vários endereços IP para uma única região adicionando endereços IP separados por vírgula. Os nomes das regras de encaminhamento são valores aceitáveis e resultam em verificação de integridade. Em
--routing-policy-type=FAILOVER
, insira o nome da regra de encaminhamento que você criou no formato${region}=${Forwarding rule name}
.
- Para
--enable-geo-fencing
: para políticas de roteamento deGEO
, isso determina se o tráfego deve fazer failover entre as regiões se todos os endpoints de uma região não estiverem íntegros. Quando definido, o Cloud DNS sempre direciona as consultas para a região mais próxima, mesmo que todos os endpoints dessa região não estejam íntegros. Use--no-enable-geo-fencing
para desativar a fronteira geográfica virtual. Quando não definido, todos os endpoints de uma região não estão íntegros, e o Cloud DNS direciona as consultas para a região mais próxima. A configuração padrão éfalse
.ROUTING_POLICY_PRIMARY_DATA
: o destino principal a ser usado para políticas de roteamentoFAILOVER
. Esse destino precisa ser uma referência a uma ou mais regras de encaminhamento, comoforwarding-rule-1
. Contanto que pelo menos uma dessas regras de encaminhamento esteja íntegra, os endereços IP de todas as regras de encaminhamento íntegras serão usados para responder às consultas desse nome.ROUTING_POLICY_BACKUP_DATA
: o destino de backup a ser usado para as políticas de roteamento deFAILOVER
. Esses destinos são usados quando todas as regras de encaminhamento especificadas em--routing-policy-primary-data
não estão íntegras. O Cloud DNS só é compatível com destinos de backup baseados em localização geográfica. O formato desse campo corresponde ao de--routing-policy-data
quando--routing-policy-type = 'GEO'
, comoasia-east1=forwarding-rule-2
.BACKUP_DATA_TRICKLE_RATIO
: a proporção de tráfego a ser enviada aos destinos de backup, mesmo quando as primárias estão íntegras. A proporção precisa estar entre 0 e 1, como0.1
. O padrão é 0.--enable-health-checking
: ativa a verificação de integridade das regras de encaminhamento fornecidas como rrdata para--routing-policy-data
.
API
Use o método resourceRecordSets.patch
. Especifique apenas rrset.rrdatas
ou rrset.routingPolicy
. Se
você especificar routingPolicy
, será necessário especificar o novo campo routingPolicy
inteiro.
WRR
Para políticas WRR
, use o seguinte método:
PATCH https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets { "name": "RRSET_NAME.", "type": "RRSET_TYPE", "ttl": TTL, "routingPolicy": { "wrrPolicy": { "item": [ { "weight": WEIGHT, "rrdatas": ["RRDATA"] }, { "weight": WEIGHT, "rrdatas": ["RRDATA"] } ], } } }
Geolocalização
Use o seguinte método:
PATCH https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets { "name": "RRSET_NAME", "type": "RRSET_TYPE", "ttl": TTL, "routingPolicy": { "geo": { "items": [ { "location": "LOCATION", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCER_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT" "region": "REGION" } ] } }, { "location": "LOCATION", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "LOAD_BALANCING_TYPE" "ipAddress": "IP_ADDRESS" "port" : "PORT_NUMBER" "ipProtocol": "IP_PROTOCOL" "networkUrl": "NETWORK_URL" "project": "PROJECT" "region": "REGION" } ] } }, } ] } } }
Substitua:
PROJECT_ID
: o ID do projetoMANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoRRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.TTL
: o TTL em segundos em que o resolvedor armazena essaResourceRecordSet
em cache, como30
TRICKLE_TRAFFIC
: a proporção de tráfego a ser enviada aos destinos de backup, mesmo quando as primárias estiverem íntegras; a proporção precisa estar entre 0 e 1, como0.1
.ENABLE_FENCING
: para políticas de roteamento deGEO
, isso determina se o tráfego deve fazer failover entre regiões se todos os endpoints de uma região não estiverem íntegros. Quando definido, o Cloud DNS sempre direciona as consultas para a região mais próxima, mesmo que todos os endpoints dessa região não estejam íntegros. Quando não definido, o Cloud DNS direciona as consultas para a região mais próxima quando todos os endpoints de uma região não estiverem íntegros. O padrão éfalse
.LOCATION
: para políticas deGEO
, a geolocalização para que você precisa criar a política, comoasia-east1
WEIGHT
: para políticasWRR
, uma lista delimitada por ponto e vírgula no formato${weight_percent}=${rrdatas}
, como.8=10.128.1.1;.2=10.130.1.1
especifique o peso como qualquer decimal não negativoRRDATA
: um valor arbitrário associado ao conjunto de registros de recursos, como198.51.100.5
; também é possível inserir vários valores,rrdata1
rrdata2
rrdata3
, como198.51.100.1
203.0.113.1
...LOAD_BALANCER_TYPE
: o tipo de balanceador de carga, comoregionalL4ilb
,globalL7ilb
ouregionalL7ilb
. Essa configuração é opcional.IP_ADDRESS
: o endereço IP que a regra de encaminhamento veicula.PORT_NUMBER
: o número da portaIP_PROTOCOL
: define o protocolo usado para a verificação de integridade. as opções válidas sãotcp
eudp
NETWORK_URL
: o URL da rede a que esta regra de encaminhamento se aplica.REGION
: a região em que você criou a regra de encaminhamento
Excluir políticas de roteamento de DNS
Para excluir uma política de roteamento, é necessário excluir o conjunto de registros de recursos que contém a política de roteamento. Para fazer isso, siga estas etapas.
Console
No Trusted Cloud console, acesse a página Zonas do Cloud DNS.
Clique na zona em que você quer excluir o conjunto de registros de recursos.
Na página Detalhes da zona, marque a caixa de seleção ao lado do nome do conjunto de registros de recursos que você quer excluir.
Clique em Excluir conjuntos de registros.
gcloud
Execute o gcloud dns record-sets delete
comando:
gcloud dns record-sets delete RRSET_NAME \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE \
Substitua:
RRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,service.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.Para ver uma lista de tipos de registros compatíveis, consulte Como selecionar tipos de registro de recurso.
MANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comoservice-zone
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixo
API
Use o método resourceRecordSets.delete
.
DELETE https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Substitua:
PROJECT_ID
: o ID do projetoMANAGED_ZONE
: a zona gerenciada à qual esteResourceRecordSet
está afiliado, comomy-zone-name
; o nome desteResourceRecordSet
precisa ter o nome DNS da zona gerenciada como sufixoRRSET_NAME
: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo,test.example.com
RRSET_TYPE
: o tipo de registro de recurso desseResourceRecordSet
, comoA
.
A seguir
- Para trabalhar com zonas gerenciadas, consulte Criar, modificar e excluir zonas.
- Para achar soluções de problemas comuns que podem ser encontrados ao usar o Cloud DNS, consulte Solução de problemas.
- Para uma visão geral do Cloud DNS, consulte Visão geral do Cloud DNS.