Primeiros passos com Edge DNS

Crie uma zona do Edge DNS e um registro A pelo Azion Console, pela Azion CLI ou pela API, e consulte o registro nos nameservers da Azion.

Última atualização

Ver como Markdown Configurar agente

Este guia conduz você pela hospedagem da sua primeira zona no Edge DNS, antes de qualquer mudança pública. Ao final, você terá:

  • Uma zona para o seu domínio, servida pelos três nameservers da Azion.
  • Um registro A que mapeia www para 192.0.2.1.
  • Uma resposta autoritativa para www vinda de ns1.aziondns.net.

Dois objetos e uma configuração no registrador fazem o Edge DNS responder por um domínio. A zona contém um domínio, como example.com. Um registro pertence a uma zona e mapeia um nome dela para um valor: aqui, www para um endereço IPv4. Os três nameservers da Azion respondem às consultas de todos os registros da zona. Os resolvers da internet só consultam esses nameservers depois que o registrador do domínio delega o domínio a eles. Este guia termina antes da delegação, então o domínio continua resolvendo como antes até que você faça a mudança no registrador.

Selecione a interface que você vai usar. Os pré-requisitos, a zona e o registro seguem essa escolha.

Pré-requisitos

  • Um domínio que você controla e acesso ao registrador do domínio. Você só precisa do registrador para a delegação, no final deste guia.
  • A permissão Edit Edge DNS. Ela concede acesso para criar, editar e remover zonas, e requer View Edge DNS. Consulte Permissões de equipes.
  • O dig na sua máquina, para consultar a zona nos nameservers da Azion. Para instalá-lo, consulte Consulte uma zona com o dig.

Crie uma zona

A zona contém o seu domínio e todos os registros pelos quais o Edge DNS responde por ele. Substitua example.com pelo seu domínio em todos os passos.

Para criar a zona pela Azion CLI, execute:

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

O comando exibe o ID da zona:

Created DNS zone with ID 1235

A zona existe e está ativa. Anote o ID: o registro que você adiciona precisa dele.

Para criar a zona pela Azion API, envie uma requisição POST ao endpoint de zonas. 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}'

Um 201 retorna 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}

O array nameservers lista os três nameservers que respondem pela zona. Anote o id: o registro que você adiciona precisa dele.

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, como example-zone. O nome identifica a zona nas listas. Ele não é o domínio.

Digite o domínio

Na seção Domain Name, digite o seu domínio raiz em Domain Name, como example.com.

Mantenha Active ativado

Na seção Status, mantenha Active ativado.

Selecione Create

O Console abre a aba Records da zona. Ele confirma a zona com Your DNS zone has been created. To complete the setup, ensure the Azion nameservers are configured in your domain provider. O final deste guia trata dos nameservers.

O domínio de uma zona não pode mudar depois da criação, e nenhuma outra zona na Azion pode hospedar o mesmo domínio. Para conhecer todos os campos da zona e as regras de cada um, consulte Zonas e registros.

Adicione um registro

Um registro A mapeia um nome para um endereço IPv4. Este responde 192.0.2.1 para www.example.com. O nome de um registro é relativo à zona, então você digita www e o Edge DNS adiciona o domínio.

Para adicionar o registro pela Azion CLI, substitua <zone-id> pelo ID da zona que você criou:

azion create dns-record --zone-id <zone-id> --name www --type A --rdata 192.0.2.1 --ttl 3600

O comando exibe o ID do registro:

Created DNS record with ID 100228

A zona contém o registro. Nunca inclua o domínio em --name: o Edge DNS adiciona o domínio.

Para adicionar o registro pela Azion API, envie uma requisição POST ao endpoint de registros da zona. Substitua <zone-id> pelo id da zona que você criou:

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 '{"name":"www","type":"A","rdata":["192.0.2.1"],"ttl":3600}'

Um 201 retorna o registro, com valores padrão para os campos que a requisição omite:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 100172,
05 "description": "",
06 "name": "www",
07 "ttl": 3600,
08 "type": "A",
09 "rdata": ["192.0.2.1"],
10 "policy": "simple",
11 "weight": 255
12 }
13}

A zona contém o registro. Nunca inclua o domínio em name: o Edge DNS adiciona o domínio.

Para adicionar o registro pelo Azion Console:

Selecione + Record

Na aba Records da zona, selecione + Record. O drawer Create Record é aberto.

Digite o nome do registro

Em Name, digite www. O Console mostra o seu domínio depois do campo e o adiciona por você, então nunca digite o domínio.

Mantenha o tipo de registro A

Mantenha Record Type definido como A - IPv4 Address.

Mantenha o TTL

Mantenha TTL (seconds) em 3600.

Digite o valor

Em Value, digite 192.0.2.1.

Selecione Save

O Console mostra Edge DNS Record has been created, e o registro aparece na tabela Records.

Para conhecer todos os campos do registro, consulte Zonas e registros.

Consulte a zona nos nameservers da Azion

Consulte o nameserver da Azion diretamente, sem o cache do seu resolver, para confirmar que ele responde pelo registro. Esta verificação não exige nenhuma mudança no registrador.

Para consultar o registro em ns1.aziondns.net, substitua example.com pelo seu domínio:

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

O nameserver retorna o valor do registro:

192.0.2.1

O primeiro registro de uma zona pode levar alguns minutos para ser respondido. Se o comando não exibir nada, aguarde alguns minutos e execute-o de novo. Se ele ainda não exibir nada, consulte Um registro novo retorna NXDOMAIN.

Para ler como o nameserver respondeu, execute a consulta sem +short:

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

O cabeçalho da saída traz o status e as flags:

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

status: NOERROR com ANSWER: 1 significa que o nameserver respondeu com o registro. A flag aa marca uma resposta autoritativa, isto é, uma resposta que vem de um nameserver que hospeda a zona.

Os nameservers da Azion agora respondem pela sua zona. Os resolvers da internet ainda não consultam esses nameservers: até que o registrador delegue o domínio, um resolver público como 8.8.8.8 não encontra nenhuma delegação para a Azion.

Para que o Edge DNS responda pelo domínio, delegue o domínio, no seu registrador, aos três nameservers do Edge DNS:

  • ns1.aziondns.net
  • ns2.aziondns.com
  • ns3.aziondns.org

No Azion Console, Copy Nameserver Values, na página Zones, copia os três nomes, separados por ponto e vírgula. A API retorna os nomes no array nameservers da zona, e azion describe dns-zone --zone-id <zone-id> exibe os nomes em Nameservers:. Antes de delegar, adicione os registros de que o seu domínio precisa, com os seus próprios endereços no lugar de 192.0.2.1. Para a migração completa, consulte Migre nameservers para a Azion.

Próximos passos

Migre nameservers para a AzionDelegue o seu domínio ao Edge DNS no registrador.Zonas e registrosTodos os campos de zona e de registro, os nameservers e os erros da API.Tipos de registroO formato do valor e as regras de cada um dos 11 tipos de registro.Aponte um domínio raiz com ANAMEResponda pelo domínio raiz com um workload da Azion.