Migre nameservers para a Azion

Mova o DNS de um domínio para o Edge DNS, teste a zona, delegue o domínio aos nameservers da Azion e aponte os hostnames dele para um workload.

Última atualização

Ver como Markdown Configurar agente

Você pode migrar os nameservers de um domínio para o Edge DNS pelo Azion Console, pela Azion CLI ou pela Azion API. Depois disso, os nameservers da Azion respondem a todas as consultas DNS do domínio, e você gerencia os registros dele na Azion em vez de no seu provedor atual.

A ordem do trabalho importa. Os resolvers só consultam a Azion depois que o registrador delega o domínio, e recebem NXDOMAIN para todo nome que a zona não contém. Por isso, você recria e testa a zona primeiro e altera o registrador por último. O Edge DNS hospeda a zona, e um workload serve a sua aplicação nos hostnames cujos registros apontam para ele.

Para apontar um hostname para um workload enquanto o seu provedor atual mantém o DNS do domínio, consulte Aponte um domínio para um workload.

Selecione a sua interface uma vez. Os pré-requisitos e as etapas abaixo mostram apenas esse caminho.

Pré-requisitos

  • Um domínio que você controla, acesso ao registrador do domínio e a lista de registros que o seu provedor de DNS atual serve para ele.
  • A permissão Edit Edge DNS, que requer View Edge DNS. Consulte Permissões de equipes.
  • Um workload que serve a sua aplicação. Para criar um, consulte Primeiros passos com Workloads.
  • O dig na sua máquina, para as etapas 3 e 6. Para instalá-lo, consulte Consulte uma zona com o dig.

1. Crie a zona do domínio

O Edge DNS mantém os registros de um domínio em uma zona. Substitua example.com pelo seu domínio em todo este guia.

Para criar a zona pela Azion CLI, execute:

azion create dns-zone --name example-zone --domain example.com --active=true

A CLI retorna o ID da zona:

Created DNS zone with ID 1235

Anote o ID. A etapa 4 usa esse valor como <zone-id>.

Para criar a zona pela Azion API, envie uma requisição POST com o nome e o domínio. Substitua [TOKEN VALUE] pelo seu personal token:

Shell
01curl -X POST https://api.azion.com/v4/workspace/dns/zones \
02 -H "Authorization: Token [TOKEN VALUE]" \
03 -H "Content-Type: application/json" \
04 -d '{"name":"example-zone","domain":"example.com","active":true}'

A API responde 201 com a zona:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 1234,
05 "name": "example-zone",
06 "domain": "example.com",
07 "active": true,
08 "nameservers": ["ns1.aziondns.net", "ns2.aziondns.com", "ns3.aziondns.org"],
09 "product_version": "2.0"
10 }
11}

Anote o id. A etapa 5 usa esse valor como <zone-id>, e a etapa 4 usa o array nameservers.

Para criar a zona pelo Azion Console:

Abra a página Edge DNS

Acesse Azion Console > Edge DNS.

Selecione + Zone
Nomeie a zona

Na seção General, digite um Name que identifica a zona nas listas, como example-zone.

Digite o domínio

Na seção Domain Name, digite em Domain Name o domínio raiz que você migra, como example.com.

Mantenha Active ativado

Na seção Status, mantenha Active ativado.

Selecione Create

O Console mostra Your DNS zone has been created. To complete the setup, ensure the Azion nameservers are configured in your domain provider. e abre a aba Records da zona. A etapa 4 trata dos nameservers.

O domínio de uma zona não pode mudar, e apenas uma zona na Azion pode hospedar um domínio. Para todas as configurações da zona, consulte Crie, edite ou exclua uma zona.

2. Copie os registros do domínio

A zona responde apenas pelos registros que você adiciona a ela. Exporte ou liste os registros no seu provedor de DNS atual e recrie-os no Edge DNS antes da mudança no registrador.

Para copiar os registros:

  1. Deixe de fora os registros NS e SOA do domínio raiz. O Edge DNS responde por ambos para a própria zona, e a API recusa um registro NS em @ com 19021.
  2. Adicione todos os outros registros à zona com o mesmo nome, tipo e valor. Para os passos em cada interface, consulte Adicione, edite ou exclua um registro.
  3. Digite cada nome relativo à zona: www para www.example.com e @ para o próprio example.com. O Edge DNS adiciona o domínio, então um nome digitado com o domínio é servido com o domínio duas vezes.

A zona agora contém todos os nomes pelos quais o seu domínio responde. Para o formato do valor de cada tipo de registro, consulte Tipos de registro.

Um registro CNAME em @ é recusado com 19005. Se o seu provedor atual aponta o domínio raiz para outro hostname, use um registro ANAME, como mostra Aponte um domínio raiz com ANAME.

3. Teste a zona nos nameservers da Azion

Consulte diretamente o nameserver da Azion antes de mexer no registrador. A consulta ignora o cache do seu resolver, então mostra o que o Edge DNS responde hoje pela zona.

Para testar um registro, consulte ns1.aziondns.net por um dos nomes que você adicionou:

dig +short @ns1.aziondns.net www.example.com A

O nameserver retorna o valor do registro:

192.0.2.1

Execute a mesma consulta para cada nome e tipo que você copiou e compare cada resposta com a do seu provedor atual. Sem +short, o cabeçalho da saída mostra status: NOERROR e a flag aa, que marca uma resposta autoritativa.

O primeiro registro de uma zona pode levar alguns minutos para ser respondido. Se uma consulta não exibir nada, consulte Um registro novo retorna NXDOMAIN.

Para ver os nameservers que a zona declara para si mesma, consulte o conjunto NS dela:

dig +short @ns1.aziondns.net example.com NS

A zona lista os três nameservers do Edge DNS:

Texto
01ns3.aziondns.org.
02ns2.aziondns.com.
03ns1.aziondns.net.

A zona responde como o seu provedor atual responde. O domínio está pronto para a mudança.

4. Delegue o domínio aos nameservers da Azion

O registrador informa aos resolvers quais nameservers respondem pelo domínio. Substituir os nameservers atuais pelos da Azion leva todas as consultas do domínio para o Edge DNS.

Obtenha os três nameservers pela interface que você usou na etapa 1:

Na página Zones do Edge DNS, selecione Copy Nameserver Values. A opção copia os três nomes, separados por ponto e vírgula.

Execute azion describe dns-zone --zone-id <zone-id>. A saída lista os três nomes em Nameservers:.

Leia o array nameservers da zona, retornado na etapa 1.

Para delegar o domínio no registrador:

  1. Abra as configurações de nameserver do domínio no registrador.
  2. Substitua os nameservers atuais pelos três nameservers do Edge DNS: ns1.aziondns.net, ns2.aziondns.com e ns3.aziondns.org.
  3. Salve a alteração.

O registrador lista os três nameservers do Edge DNS para o domínio. A etapa 6 verifica quando os resolvers passam a segui-los.

Se o registrador mantém um registro DS do domínio vindo do seu provedor atual, os resolvers que validam podem rejeitar as respostas do Edge DNS. Para corrigir isso, consulte A validação falha depois de ativar o DNSSEC.

5. Aponte os hostnames para o workload

Um workload serve a sua aplicação nos hostnames que você adiciona a ele. Você adiciona cada hostname do seu domínio ao workload e depois cria na zona um registro CNAME que aponta o hostname para o domínio da Azion do workload.

Workloads substitui Domains. Se a sua conta ainda serve aplicações por meio de Domains, siga os passos de Domains no painel do Console ou os passos da API v3 no painel da API. Para saber como um workload recebe um hostname, consulte Configurações de workload e Aponte um domínio para um workload.

Para apontar um hostname para um workload com a API v4, primeiro liste os seus workloads:

Shell
01curl -X GET https://api.azion.com/v4/workspace/workloads \
02 -H "Authorization: Token [TOKEN VALUE]"

A resposta lista cada workload com os hostnames dele em domains e o domínio da Azion dele em workload_domain:

JSON
01{
02 "count": 3,
03 "results": [
04 {
05 "id": "<workload-id>",
06 "name": "My workload",
07 "active": true,
08 …
09 "domains": ["xxxxxxx.azion.app"],
10 "workload_domain_allow_access": false,
11 "workload_domain": "xxxxxxxx.map.azionedge.net",
12 "product_version": "1.0"
13 },
14 …
15 ]
16}

Anote o id do workload e o workload_domain dele. Se domains não lista nenhum dos seus hostnames, envie-os em uma requisição PATCH. Substitua <workload-id> pelo id:

Shell
01curl -X PATCH https://api.azion.com/v4/workspace/workloads/<workload-id> \
02 -H "Authorization: Token [TOKEN VALUE]" \
03 -H "Content-Type: application/json" \
04 -d '{"domains":["example.com","*.example.com"]}'

O campo domains recebe a lista de hostnames que o workload serve.

Para criar o registro CNAME, envie uma requisição POST para os registros da zona. Substitua <zone-id> pelo id da etapa 1:

Shell
01curl -X POST https://api.azion.com/v4/workspace/dns/zones/<zone-id>/records \
02 -H "Authorization: Token [TOKEN VALUE]" \
03 -H "Content-Type: application/json" \
04 -d '{"type":"CNAME","name":"www","rdata":["<your-workload>.map.azionedge.net"],"ttl":20,"description":"www record"}'

A API responde 201 com o registro. O name é relativo à zona, rdata contém o domínio do workload e ttl define o tempo de vida em segundos. Repita a requisição para cada hostname que o workload serve.

Se a sua conta usa Domains com a API v3, liste os seus domínios:

Shell
01curl -X GET https://api.azionapi.net/domains \
02 -H "Accept: application/json; version=3" \
03 -H "Authorization: Token [TOKEN VALUE]"

A resposta lista cada domínio com os hostnames dele em cnames e o domínio da Azion dele em domain_name:

JSON
01{
02 …
03 "results": [
04 {
05 "id": <domain-id>,
06 "name": "example.com CA1 DC-example.com",
07 "cnames": [],
08 "cname_access_only": true,
09 "digital_certificate_id": <digital-certificate-id>,
10 "edge_application_id": <edge-application-id>,
11 "is_active": true,
12 "domain_name": "xxxxxxxxxx.map.azionedge.net"
13 }
14 ]
15}

Anote o id do domínio e o domain_name dele. Se cnames não lista nenhum dos seus hostnames, envie-os em uma requisição PATCH. Substitua <domain-id> pelo id:

Shell
01curl -X PATCH https://api.azionapi.net/domains/<domain-id> \
02 -H "Accept: application/json; version=3" \
03 -H "Authorization: Token [TOKEN VALUE]" \
04 -H "Content-Type: application/json" \
05 -d '{"cnames":["example.com","*.example.com"]}'

Para criar o registro CNAME com a API v3, envie uma requisição POST para os registros da zona. Substitua <zone-id> pelo id da etapa 1:

Shell
01curl -X POST https://api.azionapi.net/intelligent_dns/<zone-id>/records \
02 -H "Accept: application/json; version=3" \
03 -H "Authorization: Token [TOKEN VALUE]" \
04 -H "Content-Type: application/json" \
05 -d '{"record_type":"CNAME","entry":"www","answers_list":["xxxxxxxxxx.map.azionedge.net"],"description":"www record","ttl":20}'

Na API v3, record_type é o tipo, entry é o nome relativo à zona e answers_list contém os valores. A resposta retorna o registro:

JSON
01{
02 "results": {
03 "answers_list": ["xxxxxxxxxx.map.azionedge.net"],
04 "zone_id": <zone-id>,
05 "record_type": "CNAME",
06 "ttl": 20,
07 "policy": "simple",
08 "entry": "www",
09 "id": <record-id>,
10 "description": "www record"
11 }
12}

Para apontar um hostname para um workload pelo Azion Console:

Abra a página Workloads

Acesse Azion Console > Workloads.

Abra o workload

Selecione o workload que serve a sua aplicação.

Adicione os seus hostnames

Nos campos Subdomain e Domain, adicione os hostnames do seu domínio. Se o workload já os lista, mantenha-os à mão.

Abra a página Edge DNS

Acesse Azion Console > Edge DNS.

Abra os registros da zona

Na página Zones, selecione a zona e, em seguida, selecione a aba Records.

Selecione + Record
Digite o hostname

Em Name, digite o hostname relativo à zona, como www. Digite * para todo nome que a zona não lista. O Console adiciona o domínio para você.

Selecione o tipo CNAME

Em Record Type, selecione CNAME - Canonical name.

Digite o domínio da Azion

Em Value, digite o domínio da Azion do workload, como <your-workload>.map.azionedge.net.

(Opcional) Defina o TTL e a política

Altere TTL (seconds) e Policy Type se o seu registro precisar de outros valores.

Selecione Save

O Console mostra Edge DNS Record has been created. Repita os passos do registro para cada hostname que o workload serve.

Se a sua conta usa Domains, adicione os hostnames ali em vez de em um workload:

Abra a página Domains

Acesse Azion Console > Domains.

Abra o domínio

Selecione o domínio que serve a sua aplicação.

Adicione os seus hostnames

No campo CNAME, adicione os hostnames do seu domínio. Se o domínio já os lista, mantenha-os à mão.

Em seguida, crie cada registro CNAME no Edge DNS com os passos acima e digite em Value o domínio da Azion do domínio.

Um registro com o nome * responde por todo nome que a zona não lista, então um único registro pode enviar www e blog para o workload. Para os nomes que um wildcard abrange, consulte Responda a subdomínios com wildcard.

Um registro cujo nome ninguém consultou antes de ele existir responde em segundos. Uma alteração em um registro existente pode levar alguns minutos para chegar a todos os nameservers. Para entender o motivo, consulte Como o Edge DNS funciona.

6. Verifique o domínio por um resolver público

Um resolver público só chega à Azion pela delegação que o registrador publica. Consultar um deles mostra se a internet já segue a mudança da etapa 4.

Para consultar um resolver público, execute:

dig @8.8.8.8 www.example.com A

Enquanto o resolver ainda não segue a delegação, o cabeçalho pode mostrar NXDOMAIN sem resposta:

Texto
01;; ->>HEADER<<- opcode: QUERY, status: NXDOMAIN, id: 19090
02;; flags: qr rd ra; QUERY: 1, ANSWER: 0, AUTHORITY: 1, ADDITIONAL: 1
03…

O resolver também pode retornar os registros do seu provedor anterior. Quando ele passa a seguir a delegação, retorna o mesmo valor que ns1.aziondns.net retornou na etapa 3. Se isso não acontecer, consulte Resolvers públicos retornam NXDOMAIN enquanto os nameservers da Azion respondem.

O Edge DNS agora responde pelo seu domínio. A partir daqui, você adiciona e altera os registros dele no Edge DNS, não no seu provedor anterior.

Próximos passos

Aponte um domínio raiz com ANAMEEnvie o próprio domínio raiz para um workload.Ative o DNSSEC em uma zonaAssine a zona migrada e entregue o registro DS ao registrador.Solucionar problemas de Edge DNSCorrija uma zona ou um registro que não responde como esperado.Use a integração Massive RedirectRedirecione muitos endereços de uma vez quando a migração de um domínio os altera.