Adicione um domínio a um workload
Liste um domínio seu em um workload, aponte o registro DNS para o workload domain e feche o workload domain pelo Azion Console, pela CLI ou pela API.
Você pode servir um workload em um domínio seu pelo Azion Console, pela Azion CLI ou pela API. Para usar o hostname gratuito azion.app, consulte Crie um Azion custom domain.
Nesta página, um domínio personalizado é um hostname de um domínio seu, como www.example.com. Todo workload já responde no seu workload domain, um hostname que a Azion gera no formato <id>.map.azionedge.net. Servir o seu próprio hostname exige duas alterações: o workload lista o hostname, e um registro DNS aponta o hostname para o workload domain.
Uma conta que opera na API v3 com Domains lista os seus hostnames no campo CNAME de cada domínio. Para mais informações, consulte Domains.
Selecione uma interface. Os pré-requisitos e as etapas de cada tarefa seguem a sua escolha.
Pré-requisitos
- Um workload na infraestrutura de produção cujo deployment indica uma aplicação. Um workload de staging não aceita domínio personalizado. Para criar um workload e o seu deployment, consulte Primeiros passos com Workloads.
- Um domínio que a sua conta tem permissão para usar, e acesso aos registros DNS dele no seu provedor de DNS ou no Edge DNS.
- Acesso ao Azion Console. Para mais informações, consulte Como acessar o Azion Console.
Liste o domínio no workload
Um workload responde apenas aos hostnames dos seus domínios, então um registro DNS sozinho não alcança a sua aplicação. Cada entrada é um hostname completo. Uma entrada curinga é recusada com The domain does not conform to the format defined in RFC 1035.
Para listar o domínio pela Azion CLI, salve um arquivo JSON com o ID do workload e a lista domains, aqui como domains.json. A lista guarda todos os hostnames a que o workload responde, incluindo os que ele já lista:
Atualize o workload com o arquivo:
O comando exibe o ID do workload que ele atualizou:
Para confirmar a alteração, descreva o workload:
Este trecho da saída mostra o hostname em domains, ao lado do workload domain:
Duas recusas impedem a alteração. Um domínio para o qual a sua conta não tem permissão é recusado com This account is not allowed to use the following CNAMEs: example.com., que indica o domínio. Um workload de staging recusa todo domínio personalizado com Custom hostname is not available in the environment 'Staging Infrastructure'. Para as causas e as correções, consulte Solucionar problemas de Workloads.
Aponte o domínio para o workload domain
As requisições chegam ao workload quando o DNS resolve o seu hostname para ele. Azion Console mostra o workload domain no campo Workload Domain do workload. A CLI e a API o retornam em workload_domain.
No seu provedor de DNS, crie um registro para o hostname com estes valores:
| Campo | Valor |
|---|---|
| Name | O seu hostname, como www.example.com |
| Type | CNAME |
| Value | O workload domain, como <id>.map.azionedge.net |
Quando o Edge DNS guarda a zona do seu domínio, crie o registro nele. Para um domínio apex, o registro em cada tipo de provedor e a verificação da resolução, consulte Aponte um domínio para um workload.
Quando os resolvedores carregam o registro e a alteração do workload se propaga, as requisições ao seu hostname chegam à aplicação do deployment do workload. Uma alteração de workload leva vários minutos para chegar a toda a infraestrutura distribuída da Azion, e nesse intervalo as requisições podem receber a configuração antiga ou a nova. Repita uma requisição até que as respostas coincidam.
HTTPS no seu hostname exige um certificado de servidor que o cubra. O certificado Azion SAN padrão cobre apenas o workload domain e o Azion Custom Domain. Para obter um certificado para o seu domínio, consulte Solicite um certificado Let’s Encrypt ou Envie um certificado digital.
Feche o workload domain
Com Workload Domain Allow Access ativado, o padrão, o workload também responde no seu workload domain. Desative a opção quando o workload precisar responder apenas nos seus hostnames. Faça isso depois que os seus hostnames responderem como esperado, porque um workload domain fechado deixa de servir a sua aplicação.
Para fechar o workload domain pela Azion CLI, salve um arquivo JSON com o ID do workload e workload_domain_allow_access definido como false, aqui como close.json:
Atualize o workload com o arquivo:
O comando exibe o ID do workload que ele atualizou:
Quando a alteração se propaga, uma requisição ao workload domain responde 404, enquanto os seus hostnames continuam servindo. Um workload sem nenhum hostname nos seus domínios não pode fechar o workload domain. A alteração é recusada com When the workload hostname access is blocked, the workload requires alternate domains or domains.