AWS App Runner não estará mais aberto a novos clientes a partir de 30 de abril de 2026. Se você quiser usar o App Runner, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Mudança de disponibilidade do AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciando nomes de domínio personalizados para um serviço App Runner
Quando você cria um AWS App Runner serviço, o App Runner aloca um nome de domínio para ele. Esse é um subdomínio no `awsapprunner.com` domínio de propriedade do App Runner. Você pode usar o nome de domínio para acessar o aplicativo web que está sendo executado no seu serviço.
**nota**
[Para aumentar a segurança de seus aplicativos App Runner, o *domínio\$1.awsapprunner.com* é registrado na Lista Pública de Sufixos (PSL).](https://publicsuffix.org/) Para maior segurança, recomendamos que você use cookies com um `__Host-` prefixo se precisar definir cookies confidenciais no nome de domínio padrão para seus aplicativos App Runner. Essa prática ajudará a defender seu domínio contra tentativas de falsificação de solicitação entre sites (CSRF). Para obter mais informações, consulte a página [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) na Mozilla Developer Network.
Se você possui um nome de domínio, pode associá-lo ao seu serviço App Runner. Depois que o App Runner validar seu novo domínio, você poderá usá-lo para acessar seu aplicativo, além do domínio do App Runner. Você pode associar até cinco domínios personalizados.
**nota**
Opcionalmente, você pode incluir o `www` subdomínio do seu domínio. No entanto, atualmente, isso só é suportado pela API. O console do App Runner não suporta a inclusão do `www` subdomínio do seu domínio.
**nota**
AWS App Runner não oferece suporte ao uso de zonas hospedadas privadas do Route 53. As zonas hospedadas privadas personalizam a resolução de nomes de domínio para o tráfego da Amazon VPC. Para obter mais informações sobre zonas hospedadas privadas, consulte [Trabalho com zonas hospedadas privadas](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-private.html) na documentação do Route 53.
## Associe (vincule) um domínio personalizado ao seu serviço
Ao associar um domínio personalizado ao seu serviço, você deve adicionar os registros CNAME e os registros de destino DNS ao seu servidor DNS. As seções a seguir fornecem informações sobre registros CNAME e registros de destino DNS e como usá-los.
**nota**
Se você estiver usando o Amazon Route 53 como seu provedor de DNS, o App Runner configura automaticamente seu domínio personalizado com a validação de certificado e os registros DNS necessários para vincular ao seu aplicativo web App Runner. Isso acontece quando você usa o console do App Runner para vincular seu domínio personalizado ao seu serviço. O [Gerenciar domínios personalizados](#manage-custom-domains.manage) tópico a seguir fornece mais informações.
### Registros CNAME
Quando você associa um domínio personalizado ao seu serviço, o App Runner fornece um conjunto de registros de validação de certificados para validação de certificados. Você deve adicionar esses registros de validação de certificado ao seu servidor de Sistema de Nomes de Domínio (DNS). Adicione os registros de validação do certificado, fornecidos pelo App Runner, ao seu servidor DNS. Dessa forma, o App Runner pode validar que você possui ou controla o domínio.
**nota**
Para renovar automaticamente seus certificados de domínio personalizados, certifique-se de não excluir os registros de validação de certificados do seu servidor DNS. Para obter informações sobre como resolver problemas relacionados à renovação do certificado, consulte[Renovação de certificado de domínio personalizado](manage-custom-domain-troubleshoot.md#certificate-renewal.troubleshoot).
O App Runner usa o ACM para verificar o domínio. Se você estiver usando registros CAA em seus registros DNS, certifique-se de que pelo menos um registro CAA faça referência. `amazon.com` Caso contrário, o ACM não poderá verificar o domínio e criar seu domínio com êxito.
Se você receber erros relacionados ao CAA, consulte os links a seguir para saber como resolvê-los:
+ [Problemas de Autorização da Autoridade de Certificação (CAA)](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting-caa.html)
+ [Como faço para resolver erros de CAA ao emitir ou renovar um certificado ACM?](https://aws.amazon.com/premiumsupport/knowledge-center/acm-troubleshoot-caa-errors/)
+ [Nomes de domínios personalizados](manage-custom-domain-troubleshoot.md)
**nota**
Se você estiver usando o Amazon Route 53 como seu provedor de DNS, o App Runner configura automaticamente seu domínio personalizado com a validação de certificado e os registros DNS necessários para vincular ao seu aplicativo web App Runner. Isso acontece quando você usa o console do App Runner para vincular seu domínio personalizado ao seu serviço. O [Gerenciar domínios personalizados](#manage-custom-domains.manage) tópico a seguir fornece mais informações.
### Registros de destino do DNS
Adicione os registros de destino DNS ao seu servidor DNS para direcionar o domínio do App Runner. Adicione um registro para o domínio personalizado e outro para o `www` subdomínio, se você escolher essa opção. Em seguida, aguarde até que o status do domínio personalizado se torne **Ativo** no console do App Runner. Isso normalmente leva vários minutos, mas pode levar de 24 a 48 horas (1 a 2 dias). Quando seu domínio personalizado é validado, o App Runner começa a rotear o tráfego desse domínio para seu aplicativo web.
**nota**
Para melhor compatibilidade com os serviços do App Runner, recomendamos que você use o Amazon Route 53 como seu provedor de DNS. Se você não usa o Amazon Route 53 para gerenciar seus registros DNS públicos, entre em contato com seu provedor de DNS para descobrir como adicionar registros.
*Se você estiver usando o Amazon Route 53 como seu provedor de DNS, você pode adicionar CNAME ou registro de alias para o subdomínio.* Para o *domínio raiz*, certifique-se de usar o registro de alias.
Você pode comprar um nome de domínio do Amazon Route 53 ou de outro provedor. Para comprar um nome de domínio com o Amazon Route 53, consulte [Registro de um novo domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) no *Guia do desenvolvedor do Amazon Route 53*.
Para obter instruções sobre como configurar um destino de DNS no Route 53, consulte [Roteamento de tráfego para seus recursos](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-routing-traffic-to-resources.html), no *Amazon Route 53 Developer* Guide.
Para obter instruções sobre como configurar um destino DNS em outros registradores, como Shopify GoDaddy, Hover e assim por diante, consulte a documentação específica sobre a adição de registros de destino DNS.
### Especifique um domínio para associar ao seu serviço App Runner
Você pode especificar um domínio para associar ao seu serviço App Runner das seguintes formas:
+ *Um domínio raiz* — O DNS tem algumas limitações inerentes que podem impedir você de criar registros CNAME para o nome de domínio raiz. Por exemplo, se seu nome de domínio for`example.com`, você pode criar um registro CNAME que direciona o tráfego `acme.example.com` para o seu serviço App Runner. No entanto, você não pode criar um registro CNAME que direcione o tráfego `example.com` para o seu serviço App Runner. Para criar um domínio raiz, certifique-se de adicionar um registro de alias.
Um registro de alias é específico do Route 53 e tem as seguintes vantagens em relação aos registros CNAME:
+ O Route 53 oferece mais flexibilidade, pois registros de alias podem ser criados para domínio raiz ou subdomínio. Por exemplo, se seu nome de domínio for`example.com`, você pode criar um registro que encaminha solicitações para `example.com` ou `acme.example.com` para seu serviço App Runner.
+ É mais econômico. Isso ocorre porque o Route 53 não cobra por solicitações que usam um registro de alias para rotear o tráfego.
+ *Um subdomínio* — por exemplo, `login.example.com` ou`admin.login.example.com`. Opcionalmente, você também pode associar o `www` subdomínio como parte da mesma operação. Você pode adicionar um registro CNAME ou alias para o subdomínio.
+ *Um curinga* — Por exemplo,`*.example.com`. Você não pode usar a `www` opção nesse caso. Você pode especificar um curinga somente como o subdomínio imediato de um domínio raiz e somente por si só. Essas não são especificações válidas:`login*.example.com`,`*.login.example.com`. Essa especificação curinga associa todos os subdomínios imediatos e não associa o domínio raiz em si. O domínio raiz deve ser associado em uma operação separada.
Uma associação de domínio mais específica substitui uma menos específica. Por exemplo, `login.example.com` substituições`*.example.com`. O certificado e o CNAME da associação mais específica são usados.
O exemplo a seguir mostra como você pode usar várias associações de domínio personalizadas:
1. `example.com`Associe-se à página inicial do seu serviço. Habilite o `www` para associar`www.example.com`.
1. `login.example.com`Associe-se à página de login do seu serviço.
1. `*.example.com`Associe a uma página personalizada “não encontrada”.
## Desassociar (desvincular) um domínio personalizado
Você pode desassociar (desvincular) um domínio personalizado do seu serviço App Runner. Quando você desvincula um domínio, o App Runner interrompe o roteamento do tráfego desse domínio para seu aplicativo web.
**nota**
Você deve excluir os registros do domínio que você desassociou do seu servidor DNS.
O App Runner cria internamente certificados que rastreiam a validade do domínio. Esses certificados são armazenados no AWS Certificate Manager (ACM). O App Runner não exclui esses certificados por 7 dias após um domínio ser desassociado do seu serviço ou após a exclusão do serviço.
## Gerenciar domínios personalizados
Gerencie domínios personalizados para seu serviço App Runner usando um dos seguintes métodos:
**nota**
Para melhor compatibilidade com os serviços do App Runner, recomendamos que você use o Amazon Route 53 como seu provedor de DNS. Se você não usa o Amazon Route 53 para gerenciar seus registros DNS públicos, entre em contato com seu provedor de DNS para descobrir como adicionar registros.
*Se você estiver usando o Amazon Route 53 como seu provedor de DNS, você pode adicionar CNAME ou registro de alias para o subdomínio.* Para o *domínio raiz*, certifique-se de usar o registro de alias.
------
#### [ App Runner console ]
**Para associar (vincular) um domínio personalizado usando o console do App Runner**
1. Abra o [console do App Runner](https://console.aws.amazon.com/apprunner) e, na lista **Regiões**, selecione seu Região da AWS.
1. No painel de navegação, escolha **Serviços** e, em seguida, escolha seu serviço App Runner.
O console exibe o painel do serviço com uma **visão geral do serviço**.
![\[Página do painel do serviço App Runner mostrando a lista de atividades\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/console-dashboard.png)
1. Na página do painel do serviço, escolha a guia **Domínios personalizados**.
O console mostra os domínios personalizados associados ao seu serviço ou **Nenhum domínio personalizado**.
![\[A guia Domínios personalizados na página do painel do serviço App Runner, que não mostra domínios personalizados associados\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-dashboad-domains-empty.png)
![\[A guia Domínios personalizados na página do painel do serviço App Runner, mostrando uma associação pendente de domínio personalizado.\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-dashboad-domains-one-pending.png)
1. Na guia **Domínios personalizados**, escolha **Vincular domínio**.
1. A página **Link de domínio personalizado** é exibida.
+ Se seu domínio personalizado estiver registrado no Amazon Route 53, selecione **Amazon Route 53** como **registrador de domínio**.
1. Selecione o **nome do domínio** na lista suspensa. Essa lista exibe o nome dos seus nomes de domínio do Route 53 e o ID da zona hospedada.
**nota**
Primeiro, você deve criar um domínio do Route 53 usando o serviço Amazon Route 53 a partir da mesma AWS conta que você usa para gerenciar seus outros recursos do App Runner.
1. Selecione o **tipo de registro DNS**.
1. Escolha **Vincular domínio**.
![\[A página Link de domínio personalizado, mostrando o Amazon Route 53 como o provedor de domínio selecionado.\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-domains-link-r53.png)
**nota**
Se o App Runner exibir uma mensagem de erro informando que a tentativa de configuração automática falhou, você poderá continuar configurando os registros DNS manualmente. Esse problema pode surgir se o mesmo nome de domínio tiver sido previamente desvinculado de um serviço, sem que os registros do provedor de DNS que apontam para o serviço sejam excluídos posteriormente. Nesse caso, o App Runner está impedido de sobrescrever automaticamente esses registros. Para concluir a configuração do DNS, pule o restante das etapas desse procedimento e siga as instruções em. [Configurar um registro de alias do Amazon Route 53](manage-custom-domains-route53.md)
+ Se seu domínio personalizado estiver registrado em outro registrador de domínio, selecione **Non—Amazon** para registrador de **domínios**.
1. Insira o **nome do domínio**.
1. Escolha **Vincular domínio**.
![\[A página Vincular domínio personalizado, mostrando não-Amazon como o provedor de domínio selecionado.\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-domains-link-non-amzn.png)
1. A página **Configurar DNS** é exibida.
+ Se Amazon Route 53 for seu provedor de DNS, essa etapa é opcional.
Nesse ponto, o App Runner configurou automaticamente seu domínio do Route 53 com a validação de certificado e os registros DNS necessários.
**nota**
Se esse mesmo nome de domínio tivesse sido desvinculado anteriormente de um serviço, sem que os registros do provedor de DNS que apontam para a exclusão posterior do serviço, a configuração automática que o App Runner tentou fazer poderia ter falhado. Para contornar esse problema e concluir a associação de DNS, continue com as etapas **(1)** e **(2)** na página **Configurar DNS** para copiar os registros atuais de destino e certificado para o provedor de DNS.
1. Copie os registros de validação do certificado e os registros de destino do DNS e adicione-os ao seu servidor DNS. O App Runner pode então validar que você possui ou controla o domínio.
**nota**
Para renovar automaticamente seus certificados de domínio personalizados, certifique-se de não excluir os registros de validação de certificados do seu servidor DNS.
+ Para obter mais informações sobre **Configurar a validação de certificados**, consulte [Validação de DNS](https://docs.aws.amazon.com/acm/latest/userguide/dns-validation.html) no *[Guia do AWS Certificate Manager Usuário](https://docs.aws.amazon.com/acm/latest/userguide/)*.
+ Para obter informações sobre como **configurar o destino DNS com o** registro de alias do Amazon Route 53, consulte. [Configure o registro de alias do Amazon Route 53 para seu DNS de destino](manage-custom-domains-route53.md)
+ Se você estiver usando um provedor de DNS diferente do Amazon Route 53, siga estas etapas.
1. Copie os registros de validação do certificado e os registros de destino do DNS e adicione-os ao seu servidor DNS. O App Runner pode então validar que você possui ou controla o domínio.
**nota**
Para renovar automaticamente seus certificados de domínio personalizados, certifique-se de não excluir os registros de validação de certificados do seu servidor DNS.
+ Para obter mais informações sobre **Configurar a validação de certificados**, consulte [Validação de DNS](https://docs.aws.amazon.com/acm/latest/userguide/dns-validation.html) no *[Guia do AWS Certificate Manager Usuário](https://docs.aws.amazon.com/acm/latest/userguide/)*.
+ Para obter instruções sobre como configurar um destino DNS em outros registradores, como Shopify GoDaddy, Hover e assim por diante, consulte a documentação específica sobre a adição do DNS Target.
![\[A página Configurar DNS, mostrando a validação do certificado e os registros de destino do DNS para adicionar ao seu DNS.\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/custom-domain-configure.png)
1. Escolha **Fechar**
O console mostra o painel novamente. A guia **Domínios personalizados** tem um novo quadro mostrando o domínio que você acabou de vincular no status de **validação de DNS do certificado pendente**.
![\[A guia Domínios personalizados na página do painel do serviço App Runner, mostrando um quadro de domínio personalizado\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-dashboad-domains-tile.png)
1. Quando o status do domínio mudar para **Ativo**, verifique se o domínio funciona para rotear o tráfego navegando até ele.
![\[A guia Domínios personalizados na página do painel do serviço App Runner, mostrando um quadro de domínio personalizado\]](http://docs.aws.amazon.com/pt_br/apprunner/latest/dg/images/service-dashboad-domains-tile-active.png)
**nota**
Para obter instruções sobre como solucionar erros relacionados ao domínio personalizado, consulte[Nomes de domínios personalizados](manage-custom-domain-troubleshoot.md).
**Para desassociar (desvincular) um domínio personalizado usando o console do App Runner**
1. Na guia **Domínios personalizados**, selecione o quadro do domínio que você deseja desassociar e escolha **Desvincular** domínio.
1. Na caixa de diálogo **Desvincular domínio**, verifique a ação escolhendo **Desvincular** domínio.
**nota**
Você deve excluir os registros do domínio que você desassociou do seu servidor DNS.
------
#### [ App Runner API or AWS CLI ]
Para associar um domínio personalizado ao seu serviço usando a API App Runner ou AWS CLI chame a ação da [AssociateCustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_AssociateCustomDomain.html)API. Quando a chamada é bem-sucedida, é retornado um [CustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_CustomDomain.html)objeto que descreve o domínio personalizado que está sendo associado ao seu serviço. O objeto mostra um `CREATING` status e contém uma lista de [CertificateValidationRecord](https://docs.aws.amazon.com/apprunner/latest/api/API_CertificateValidationRecord.html)objetos. A chamada também retorna o alias de destino que você pode usar para configurar o destino DNS. Esses são registros que você pode adicionar ao seu DNS.
Para desassociar um domínio personalizado do seu serviço usando a API App Runner ou AWS CLI chame a ação da [DisassociateCustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_DisassociateCustomDomain.html)API. Quando a chamada é bem-sucedida, é retornado um [CustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_CustomDomain.html)objeto que descreve o domínio personalizado que está sendo desassociado do seu serviço. O objeto mostra um `DELETING` status.
------
**Topics**
+ [Associe (vincule) um domínio personalizado ao seu serviço](#manage-custom-domains.associate-custom-domain)
+ [Desassociar (desvincular) um domínio personalizado](#manage-custom-domains.disassociate-custom-domain)
+ [Gerenciar domínios personalizados](#manage-custom-domains.manage)
+ [Configure o registro de alias do Amazon Route 53 para seu DNS de destino](manage-custom-domains-route53.md)
# Configure o registro de alias do Amazon Route 53 para seu DNS de destino
**nota**
Você não precisa seguir esse procedimento se o Amazon Route 53 for seu provedor de DNS. Nesse caso, o App Runner configura automaticamente seu domínio do Route 53 com a validação de certificado e os registros DNS necessários para vincular ao seu aplicativo web App Runner.
Se a tentativa de configuração automática do App Runner falhar, siga este procedimento para concluir a configuração do DNS. Se o mesmo nome de domínio tiver sido anteriormente desvinculado de um serviço, sem que os registros do provedor de DNS que apontam para o serviço sejam excluídos posteriormente, o App Runner será impedido de sobrescrever automaticamente esses registros. Este procedimento explica como copiá-los manualmente para o DNS do Route 53.
Você pode usar o Amazon Route 53 como seu provedor de DNS para rotear o tráfego para o seu serviço App Runner. É um serviço web de Sistema de Nomes de Domínio (DNS) altamente disponível e escalável. O registro do Amazon Route 53 contém as configurações que controlam como o tráfego é roteado para o seu serviço App Runner. Você cria um registro CNAME ou um registro ALIAS. Para uma comparação entre registros CNAME e alias, consulte [Escolha entre registros alias e sem alias,](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-choosing-alias-non-alias.html) no *Amazon* Route 53 Developer Guide.
**nota**
Atualmente, o Amazon Route 53 oferece suporte ao registro de alias para serviços criados após 1º de agosto de 2022.
------
#### [ Amazon Route 53 console ]
**Para configurar o registro de alias do Amazon Route 53**
1. Faça login Console de gerenciamento da AWS e abra o [console do Route 53](https://console.aws.amazon.com/route53/).
1. No painel de navegação, escolha **Zonas hospedadas**.
1. Escolha o nome da zona hospedada que você deseja usar para rotear o tráfego para seu serviço App Runner.
1. Escolha **Create record** (Criar registro).
1. Especifique os seguintes valores:
+ **Política de roteamento**: escolha a política de roteamento aplicável. Para obter mais informações, consulte [Escolha de uma política de roteamento](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html).
+ **Nome do registro**: insira o nome de domínio que você deseja usar para rotear o tráfego para seu serviço App Runner. O valor padrão é o nome da zona hospedada. Por exemplo, se o nome da zona hospedada for `example.com` e você quiser usar para `acme.example.com` rotear o tráfego para seu ambiente, insira`acme`.
+ **Valorizar/rotear o tráfego para**: escolha **Alias para o aplicativo App Runner** e, em seguida, escolha a **região** de origem do endpoint. Escolha o nome de domínio do aplicativo para o qual você deseja rotear o tráfego.
+ **Tipo de registro**: aceite o ** IPv4 endereço padrão, A —**.
+ **Avalie a integridade do alvo**: aceite o valor padrão, **Sim**.
1. Escolha **Criar registros**.
O registro de alias do Route 53 que você criou é propagado em todos os servidores do Route 53 em 60 segundos. Quando os servidores do Route 53 são propagados com seu registro de alias, você pode rotear o tráfego para seu serviço App Runner usando o nome do registro de alias que você criou.
Para obter informações sobre como solucionar problemas se as alterações de DNS estão demorando muito para se propagar, consulte [Por que minhas alterações de DNS estão demorando tanto para se propagarem no Route 53 e nos](https://aws.amazon.com/premiumsupport/knowledge-center/route-53-propagate-dns-changes/) resolvedores públicos? .
------
#### [ Amazon Route 53 API or AWS CLI ]
Para configurar o registro de alias do Amazon Route 53 usando a API do Amazon Route 53 ou AWS CLI chamar a ação da [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html)API. Para saber mais sobre o ID da zona hospedada de destino do Route 53, consulte [Endpoints de serviço](https://docs.aws.amazon.com/general/latest/gr/apprunner.html).
------