Usar um nome de domínio personalizado
Nesta página
Visão geral
Você pode usar seu próprio nome de domínio personalizado para seu conteúdo hospedado. Por padrão, o conteúdo que você carrega estará disponível em um domínio com a seguinte forma:
<Your App ID>.mongodbstitch.com
Você pode configurar um nome de domínio personalizado para o conteúdo hospedado do seu aplicativo a partir da interface do usuário do App Services ou importando um diretório de configuração do aplicativo que especifica o domínio em seu arquivo de configuração config.json. Selecione a aba abaixo que corresponde ao método que você deseja usar.
Procedimento
Especifique o Domínio Personalizado no Atlas App Services
Você precisa fornecer seu nome de domínio personalizado ao App Services para que ele possa veicular conteúdo do domínio. Para especificar o domínio:
Clique em Hosting no menu de navegação esquerdo.
Clique na aba Settings.
Em Custom Domain, defina a opção como Enabled.
Insira seu domínio personalizado na caixa de entrada sob o botão Enabled. Esse valor deve ser o domínio raiz sem subdomínios. Por exemplo, você deve inserir
example.comem vez dewww.example.com.Clique em Save.
Observação
Se for encontrado um erro durante a validação do nome de domínio personalizado, o App Services enviará ao proprietário do projeto um e-mail alertando-o sobre o problema.
Adicionar um registro CNAME de validação
Para verificar se você é o proprietário do domínio, você deve adicionar um novo registro na configuração de DNS do seu domínio. A seção Custom Domain incluirá uma caixa de informações que lista o nome do host e o valor de destino a serem usados no registro.
Depois de adicionar o registro de validação, pode levar algum tempo para que o registro DNS se propague. O App Services verificará periodicamente os registros DNS do domínio em busca da validação CNAME e marcará o domínio como verificado se encontrar o registro.
Dica
Solução de problemas
No campo Name da interface do usuário do App Services, o App Services fornece o endereço completo para o registro CNAME,
<Subdomain>.<Your Base Domain>. No entanto, muitos provedores de hospedagem apenas solicitam a parte<Subdomain>para inserir em sua interface de usuário. Se você tiver problemas, verifique a documentação do provedor de hospedagem sobre como adicionar registros CNAME.É possível que o App Services não consiga encontrar o registro de validação se seu provedor de DNS enviar por proxy as solicitações do domínio. Se o App Services não conseguir validar seu domínio, verifique se você desativou todos os proxies HTTP para o registro CNAME de validação no seu provedor de DNS.
Se for encontrado um erro durante a validação do nome de domínio personalizado, o App Services enviará ao proprietário do projeto um e-mail alertando-o sobre o problema.
Adicionar um registro CNAME de redirecionamento
Depois que o App Services verificar seu domínio, basta adicionar um registro DNS CNAME para o seu domínio que aponte para o domínio padrão do App Services. Use o seguinte nome de host e valor de destino:
Valor | Descrição | |
|---|---|---|
Nome do host | Um subdomínio como www. | |
Alvo | O domínio padrão do seu aplicativo. Este valor está listado como App Services Domain na aba Settings da página Hosting. O domínio padrão tem o seguinte formato: |
Obtenha a versão mais recente da sua aplicação
Para configurar um nome de domínio personalizado com a App Services CLI, você precisa de uma cópia local dos arquivos de configuração do seu aplicativo.
Para extrair uma cópia local da versão mais recente do seu aplicativo, execute o seguinte:
appservices pull --remote="<Your App ID>"
Dica
Você também pode baixar uma cópia dos arquivos de configuração do seu aplicativo na tela Deploy > Import/Export App na interface do usuário do App Services.
Especifique o domínio personalizado
Em hosting/config.json, defina custom_domain para seu nome de domínio personalizado e salve o arquivo.
{ "enabled": true, "custom_domain": "example.com" }
Observação
O valor de custom_domain deve ser o domínio raiz sem subdomínios. Por exemplo, você deve inserir example.com em vez de www.example.com.
Distribuir a configuração de hospedagem atualizada
Depois de atualizar e salvar hosting/config.json , você poderá enviar a configuração atualizada para seu aplicativo remoto. O App Services CLI implementa imediatamente a configuração em push e o App Services começa imediatamente a tentar verificar seu nome de domínio.
appservices push --remote="<Your App ID>" --include-hosting
Adicionar um registro CNAME de validação
Para verificar se você é o proprietário do domínio, adicione um novo registro CNAME na configuração de DNS do seu domínio. Você pode encontrar o nome do host e o valor de destino a serem usados na seção Custom Domain de registro da guia Hosting > Settings na interface do usuário do App Services.
Depois de adicionar o registro de validação, pode levar algum tempo para que o registro DNS se propague. O App Services verificará periodicamente os registros DNS do domínio em busca da validação CNAME e marcará o domínio como verificado se encontrar o registro.
Dica
Solução de problemas
No campo Name da interface do usuário do App Services, o App Services fornece o endereço completo para o registro CNAME,
<Subdomain>.<Your Base Domain>. No entanto, muitos provedores de hospedagem apenas solicitam a parte<Subdomain>para inserir em sua interface de usuário. Se você tiver problemas, verifique a documentação do provedor de hospedagem sobre como adicionar registros CNAME.É possível que o App Services não consiga encontrar o registro de validação se seu provedor de DNS enviar por proxy as solicitações do domínio. Se o App Services não conseguir validar seu domínio, verifique se você desativou todos os proxies HTTP para o registro CNAME de validação no seu provedor de DNS.
Se for encontrado um erro durante a validação do nome de domínio personalizado, o App Services enviará ao proprietário do projeto um e-mail alertando-o sobre o problema.
Adicionar um registro CNAME de redirecionamento
Depois que o App Services verificar seu domínio, tudo o que resta a fazer é adicionar um ou mais registros DNS CNAME para o seu domínio que ponto para o domínio padrão do App Services. Use o seguinte nome de host e valor de destino:
Valor | Descrição | |
|---|---|---|
Nome do host | Um subdomínio como www. | |
Alvo | O domínio padrão do seu aplicativo. Este valor está listado como App Services Domain na aba Settings da página Hosting. O domínio padrão tem o seguinte formato: |
Observação
Adicione AWS CAAs do App Services para verificar seu domínio
Se você tiver problemas para verificar seu domínio:
limpar todos os CAAs desnecessários dos registros do seu site
adicione os seguintes registros CAA:
DomínioTipo de registroFlagsTagValorwww.example.comCAA0issue"amazon.com"www.example.comCAA0issue"amazontrust.com"www.example.comCAA0issue"awstrust.com"