Como migrar nameservers para a Azion

A Azion permite que você hospede e gerencie zonas e registros DNS redirecionando a resolução DNS do seu provedor de domínio para os nameservers (NS) autoritativos da Azion através do Edge DNS.

Passo 1: Criar uma zona DNS

Para criar uma zona DNS para o domínio seudominio.org:

Acesse o Azion Console > Edge DNS.
Clique no botão + Zone.
Dê um nome fácil de lembrar para sua zona.
Indique o FQDN conforme registrado no DNS. Exemplo: seudominio.org.
Clique no botão Save.

Para obter os nameservers da Azion:

Clique no botão Copy Nameserver Values para obter os nameservers da Azion:

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

Mantenha esses valores em mão para quando você redirecionar os nameservers autoritativos do seu domínio.

Acesse o Real-Time Manager (RTM).
No canto superior esquerdo da página, clique nas três linhas horizontais para abrir o Products menu e selecione Edge DNS.
Clique no botão Add Zone.
Dê um nome fácil de lembrar para sua zona.
Indique o FQDN conforme registrado no DNS. Exemplo: seudominio.org.
Clique no botão Save.

Você será redirecionado para a sua lista de zonas. Para obter os nameservers da Azion:

Clique na zona que você criou.
Na tela da zona, em Nameservers, você verá os nameservers da Azion:

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

Mantenha esses valores em mão para quando você redirecionar os nameservers autoritativos do seu domínio.

Execute a seguinte requisição POST no seu terminal, substituindo [TOKEN VALUE] pelo seu personal token e adicionando o endereço do seu domínio no campo domain:

curl --location 'https://api.azionapi.net/intelligent_dns' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Accept: application/json; version=3' \
--header 'Content-Type: application/json' \
--data '{ "name": "seudominio.com", "domain": "seudominio.com", "is_active": true
}'

Chave	Descrição
`name`	Define a string no valor como um nome da entrada de zona com a Azion.
`domain`	Define o domínio apex.
`is_active`	Quando `true`, ativa a zona.

Você receberá uma resposta semelhante a esta:

{ "results": [ { "nx_ttl": 3600, "domain": "seudominio.com", "retry": 7200, "name": "seudominio.com - zone", "nameservers": [ "ns1.aziondns.net", "ns2.aziondns.com", "ns3.aziondns.org" ], "soa_ttl": 3600, "is_active": true, "refresh": 43200, "expiry": 1209600, "id": 3211 } ]
}

Copie os valores dentro do campo nameservers. Esses valores serão usados para redirecionar os nameservers do seu domínio.
Copie também o valor id para quando você associar uma edge application à sua zona.

Passo 2: Redirecionar nameservers autoritativos

O próximo passo é redirecionar os nameservers autoritativos do seu domínio, e para isso, você precisará acessar seu provedor de domínio e modificar seus registros NS. Aqui estão alguns dos provedores de domínio mais populares e como eles lidam com as mudanças de nameserver DNS:

A Azion recomenda que você adicione todos os três nameservers disponíveis da Azion para maior confiabilidade:

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

Uma vez que seus registros de nameserver tenham sido atualizados para os endereços da Azion, você poderá criar registros diretamente da Azion. Veja a próxima seção para um exemplo de como fazer isso.

Passo 3: Criar registro de edge application na zona DNS

Depois de ter migrado com sucesso sua zona DNS para a Azion, você não precisará acessar seu provedor de domínio para criar novos registros, pois você pode fazer isso diretamente com a Azion. Isso significa que você pode lançar sua edge application com seu domínio personalizado e criar novas aplicações e registros conforme necessário.

Para associar uma nova edge application ao seu domínio, você precisará criar um novo registro CNAME na sua zona e associá-lo a uma edge application.

Para personalizar o domínio da sua edge application sob a nova zona, você precisa associar o CNAME da sua edge application a um novo registro. Recupere os domínios personalizados listados para a aplicação seguindo os passos:

Acesse o Azion Console > Domains.
Clique no domínio que você deseja associar ao seu domínio personalizado.
No campo CNAME, adicione os domínios personalizados para a aplicação que deve estar sob sua zona DNS. Se você já adicionou um domínio personalizado, copie esses valores e mantenha-os em mão.

Agora você precisará navegar até a área Edge DNS para adicionar um registro para os CNAMEs da sua edge application:

No canto superior esquerdo da página, abra o Products menu, representado por três linhas horizontais, e selecione Edge DNS.
Selecione a zona DNS.
Selecione a aba Records.
Clique no botão + Record.
Em Name, crie um hostname ou subdomínio. Por exemplo: *.
Em Record Type, selecione CNAME - Canonical name.
Em Value, insira o endereço de domínio da Azion no formato FQDN. Exemplo: xxxxxxxxxx.map.azionedge.net
Defina o TTL e a Policy conforme desejado.
Clique no botão Save.

Repita o processo descrito acima para cada CNAME listado para sua application. Espere alguns minutos para que as mudanças se propaguem. Você pode executar o comando DIG no seu terminal para verificar se o seu domínio aponta para o endereço da Azion.

Acesse o Real-Time Manager (RTM).
No canto superior esquerdo da página, abra o Products menu, representado por três linhas horizontais, e selecione Domains.
Clique no domínio que você deseja associar ao seu domínio personalizado.
No campo CNAME, adicione os domínios personalizados para a aplicação que deve estar sob sua zona DNS. Se você já adicionou um domínio personalizado, copie esses valores e mantenha-os em mão.

Agora você precisará navegar até a área Edge DNS para adicionar um registro para os CNAMEs da sua edge application:

No canto superior esquerdo da página, abra o Products menu, representado por três linhas horizontais, e selecione Edge DNS.
Selecione a zona DNS.
Selecione a aba Records.
Em Name, crie um hostname ou subdomínio. Por exemplo: *.
Em Type, selecione CNAME - Nome canônico.
Em Value, insira o endereço de domínio da Azion no formato FQDN. Exemplo: xxxxxxxxxx.map.azionedge.net
Defina o TTL e a Policy conforme desejado.
Clique no botão Save.

Execute a seguinte requisição GET para recuperar o ID do seu domínio, substituindo [TOKEN VALUE] pelo seu personal token:

curl --location 'https://api.azionapi.net/domains' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \

Você receberá uma resposta semelhante a esta:

{
    ...
    "results": [
        {
            "id": <domain_id>,
            "name": "seudominio.com CA1 DC-seudominio.com",
            "cnames": [],
            "cname_access_only": true,
            "digital_certificate_id": <digital_certificate_id>,
            "edge_application_id": <edge_application_id>,
            "is_active": true,
            "domain_name": "xxxxxxxxxx.map.azionedge.net"
        }
    ]
}

Localize o domínio que você deseja vincular ao domínio personalizado e copie o valor domain_id recebido na resposta.
Se você não tem CNAMEs listados, execute uma requisição PATCH, adicionando o domain_id como um caminho, para atualizar o campo cnames com os domínios que você deseja configurar:

curl --location --request PATCH 'https://api.azionapi.net/domains/<domain_id>' \
--header 'Accept: application/json; version=3' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Content-Type: application/json' \
--data '{
    "cnames": [
        "seudominio.com",
        "*.seudominio.com"
    ]
}'

Chave	Descrição
`cnames`	Aceita uma lista de CNAMEs para os domínios como valores. Por exemplo, `["*.seudominio.com", "blog.seudominio.com"]`.

Execute uma nova requisição GET para recuperar o hosted_zone_id, que indica a zona DNS que você criou:

{
    ...
    "results": [
        {
            "domain": "yourdomain.com - zone",
            "is_active": true,
            "name": "yourdomain.com",
            "id": <hosted_zone_id>
        }
    ]
}

Execute a seguinte requisição POST no seu terminal, substituindo [TOKEN VALUE] pelo seu personal token, hosted_zone_id pelo valor da resposta anterior e a lista de respostas com o endereço de domínio da Azion como uma string:

curl --location 'https://api.azionapi.net/intelligent_dns/<hosted_zone_id>/records' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token [TOKEN VALUE]' \
--header 'Accept: application/json; version=3' \
--data-raw '{
    "record_type": "CNAME",
    "entry": "www",
    "answers_list": [
        "xxxxxxxxxx.map.azionedge.net"
    ],
    "description": "www record",
    "ttl": 20
}'

Chave	Descrição
`record_type`	O tipo de registro sendo criado. Veja a lista completa de tipos de registro aceitos na documentação do Edge DNS.
`entry`	Define o valor da entrada quando anexado ao domínio apex da zona para gerar o registro. Por exemplo, o valor `www` representará um registro para `www.seudominio.com`. Aceita a notação wildcard (`*`).
`answers_list`	Aceita uma lista de CNAMEs para os domínios como valores. No exemplo descrito acima, o CNAME é o endereço Azion.
`description`	Define a string como uma descrição do registro.
`ttl`	Define o tempo de vida (TTL) do registro em segundos.

Você receberá uma resposta confirmando que o novo registro foi criado:

{
    "results": {
        "answers_list": [
            "xxxxxxxxxx.map.azionedge.net"
        ],
        "zone_id": <hosted_zone_id>,
        "record_type": "CNAME",
        "ttl": 20,
        "policy": "simple",
        "entry": "www",
        "id": <record_id>,
        "description": "www record"
    }
}

Aguarde alguns minutos para que as alterações propaguem para o edge. Você pode executar o comando DIG no seu terminal para verificar se o seu domínio aponta para o endereço da Azion.