--- name: azion-crie-um-azion-custom-domain description: >- Dê a um workload um hostname azion.app gratuito que a Azion atende por HTTPS, pelo Azion Console, pela Azion CLI ou pela API. --- # Crie um Azion custom domain Você pode dar a um [workload](/pt-br/documentacao/plataforma/workloads/) um hostname gratuito sob `azion.app` pelo Azion Console, pela [Azion CLI](/pt-br/documentacao/devtools/cli/) ou pela API. Para atender um domínio seu, como `www.example.com`, consulte [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/). O Azion custom domain é um hostname que você escolhe, no formato `.azion.app`, como `my-custom-name.azion.app`. Ele é diferente do workload domain, o hostname `.map.azionedge.net` que a Azion gera ao criar o workload. O workload armazena o Azion custom domain como uma entrada dos seus domínios, ao lado de qualquer domínio seu. O Azion custom domain está disponível sem custo adicional. --- Escolha uma interface. Cada tarefa abaixo mostra os pré-requisitos e os passos da sua escolha. ## Pré-requisitos - Um workload na infraestrutura de produção cujo deployment nomeia uma aplicação. Um workload de staging não aceita Azion custom domain. Para criar o workload e o deployment dele, consulte [Primeiros passos com Workloads](/pt-br/documentacao/plataforma/workloads/primeiros-passos/). - Um nome que nenhum outro workload carrega sob `azion.app`. **Console** - Acesso ao Azion Console. Para mais informações, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). **CLI** - A Azion CLI, autorizada com a sua conta. Os comandos desta página correspondem à Azion CLI 4.23.0. - O ID do workload, que `azion create workload` imprime como `Created Workload with ID `. **API** - Um personal token, enviado no header `Authorization` como `Token [TOKEN VALUE]`. Para criar um, consulte [Tokens pessoais](/pt-br/documentacao/fundamentos/personal-tokens/). - `curl` ou outro cliente HTTP. - O ID do workload, que `azion create workload` imprime como `Created Workload with ID `. --- ## Adicione o Azion custom domain ao workload O workload responde no Azion custom domain assim que o hostname completo está nos domínios dele. Você escolhe apenas o nome: o sufixo `.azion.app` é fixo. **Console** No Azion Console, a seção **Domains** do formulário do workload contém o switch **Custom Domain**, descrito como "You can use an free azion.app domain." O formulário **Create Workload** traz o mesmo switch e o mesmo campo, então você também pode definir o nome ao criar um workload. Para adicionar o Azion custom domain a um workload existente: 1. **Abra a página Workloads** Acesse [Azion Console](https://console.azion.com/) > **Workloads**. 2. **Abra o workload** Selecione o workload de produção. O formulário de edição dele abre. 3. **Ative Custom Domain** Na seção **Domains**, ative **Custom Domain**. O campo **Azion Custom Domain** aparece. 4. **Digite o nome** Em **Azion Custom Domain**, digite o nome, como `my-custom-name`. O campo acrescenta `.azion.app`. 5. **Salve o workload** Selecione **Save**. Azion Console mostra "Your workload has been updated". O workload lista `.azion.app` nos domínios dele. **CLI** Para adicionar o Azion custom domain com a Azion CLI, salve um arquivo JSON com o ID do workload e a lista `domains`, aqui como `azion-app.json`. Mantenha na mesma lista todos os domínios que o workload já lista: ```json { "id": , "domains": [".azion.app"] } ``` Atualize o workload com o arquivo: ```bash azion update workload --file azion-app.json ``` O comando imprime o ID do workload atualizado: ```text Updated Workload with ID ``` Para confirmar a alteração, descreva o workload: ```bash azion describe workload --workload-id --format json ``` Este trecho da saída lista o Azion custom domain em `domains`, separado do workload domain: ```json { "domains": [".azion.app"], … "workload_domain": ".map.azionedge.net" } ``` **API** Para adicionar o Azion custom domain com a API, envie uma requisição `PATCH` para o workload. Mantenha na mesma lista `domains` todos os domínios que o workload já lista: ```bash curl --request PATCH \ --url https://api.azion.com/v4/workspace/workloads/ \ --header 'Accept: application/json' \ --header 'Authorization: Token [TOKEN VALUE]' \ --header 'Content-Type: application/json' \ --data '{ "domains": [".azion.app"] }' ``` A API aceita a atualização, e o workload passa a listar `.azion.app` em `domains`. A API armazena o nome com a caixa que você envia, então `My-Site.azion.app` é lido de volta como `My-Site.azion.app`. A alteração é recusada em quatro casos, cada um com a sua mensagem: - **Um segundo hostname `azion.app` no mesmo workload.** Um workload carrega um só, quer a lista repita um nome, quer traga dois nomes: `Duplicated usage of suffix in alternate_domains: 'azion.app'.` - **Um nome que outro workload carrega.** Um nome `azion.app` pertence a um workload e não é compartilhado entre contas ou configurações: `The custom hostname is not available.` - **Um nome wildcard**, como `*.azion.app`: `The domain does not conform to the format defined in RFC 1035.` - **Um workload de staging.** O Console desativa o switch **Custom Domain** e o torna indisponível, e a CLI e a API retornam `Custom hostname is not available in the environment 'Staging Infrastructure'.` Para as causas e as correções, consulte [Solucionar problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas/). --- ## Abra o Azion custom domain O Azion custom domain não precisa de nenhum registro DNS seu nem de nenhum certificado seu. Com `tls.certificate` definido como `null`, o padrão, o workload atende HTTPS com o certificado SAN da Azion, que cobre o Azion custom domain e o workload domain. Para mais informações, consulte [Como Workloads funciona](/pt-br/documentacao/plataforma/workloads/como-funciona/). Uma alteração no workload leva vários minutos para chegar a toda a infraestrutura distribuída da Azion. Até a alteração chegar, uma requisição para `https://.azion.app` responde `404` com a página de erro HTML da Azion. As requisições podem receber a configuração antiga ou a nova por um tempo, então repita a requisição até as respostas coincidirem. Depois que a alteração se propaga, uma requisição para `https://.azion.app` chega à aplicação no deployment do workload e retorna a resposta dela, como `200`. --- ## Próximos passos - [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio.md): Atenda o mesmo workload em um domínio seu, ao lado do Azion custom domain. - [Vincule um firewall a um workload](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/proteja-seu-dominio.md): Inspecione as requisições que chegam ao Azion custom domain antes que a aplicação as responda. - [Configurações de workload](/pt-br/documentacao/plataforma/workloads/configuracoes.md#dominios): Consulte cada regra que o campo de domínios segue e o erro que cada uma retorna. - [Solucionar problemas de Workloads](/pt-br/documentacao/plataforma/workloads/solucao-de-problemas.md): Descubra por que um hostname é recusado ou por que um workload ainda responde 404.