Início Rápido: mapear um domínio personalizado para Aplicativos Spring do Azure com o plano de consumo básico e dedicado

Este artigo se aplica ao: ✔️ Consumo padrão e dedicado (versão prévia) ❌ Básico/Standard ❌ Enterprise

Este artigo mostra como mapear um domínio de site personalizado, como https://www.contoso.com, para seu aplicativo nos Aplicativos Spring do Azure. Esse mapeamento é realizado usando um registro CNAME que o DNS (Domain Name System) usa para armazenar nomes de nó em toda a rede.

O mapeamento protege o domínio personalizado com um certificado e impões o protocolo TLS, também conhecido como protocolo SSL.

Pré-requisitos

• Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
• CLI do Azure
• Uma instância de serviço do plano de consumo padrão e dedicado dos Aplicativos Spring do Azure. Para obter mais informações, consulte Início Rápido: provisionar uma instância de serviço do plano de consumo Standard e dedicado dos Aplicativos Spring do Azure.
• Um aplicativo Spring implantado no Aplicativos Spring do Azure.
• Um nome de domínio registrado no registro DNS, conforme fornecido por um provedor de domínio ou hospedagem web.
• Um recurso de certificado criado em um ambiente dos Aplicativos de Contêiner do Azure. Para obter mais informações, confira o tópico Adicionar certificado no Aplicativo de Contêiner.

Mapear um domínio personalizado

Para mapear o domínio personalizado, crie o registro CNAME e use a CLI do Azure para associar o domínio a um aplicativo nos Aplicativos Spring do Azure.

Primeiro, use as etapas a seguir para criar um registro CNAME:

1. Entre em contato com seu provedor DNS para solicitar um registro CNAME para mapear seu domínio para o FQDN (Fully Qualified Domain Name) do aplicativo Spring.

2. Adicione um registro TXT com o nome asuid.{subdomain} e o valor sendo a ID de verificação de ambiente dos Aplicativos de Contêiner do Azure. Você pode obter esse valor usando o comando a seguir.

   az containerapp env show \
       --resource-group <resource-group-name> \
       --name <Azure-Container-Apps-environment-name> \
       --query 'properties.customDomainConfiguration.customDomainVerificationId'
   

   Depois de adicionar o registro CNAME e TXT, a página de registros DNS será parecida com a seguinte tabela.

   Nome	Tipo	Valor
   {subdomain}	CNAME	testapp.agreeablewater-4c8480b3.eastus.azurecontainerapps.io
   asuid.{subdomain}	A	6K861CL04CATKUCFF604024064D57PB52F5DF7B67BC3033BA9808BDA8998U270

3. Em seguida, associe o domínio personalizado ao seu aplicativo usando o comando a seguir.

   az spring app custom-domain bind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --app <app-name> \
       --domain-name <your-custom-domain-name> \
       --certificate <name-of-your-certificate-under-Azure-Container-Apps-environment>
   

Limpar recursos

Exclua os recursos que você criou neste artigo quando não precisar mais deles. Para excluir os recursos, basta excluir o grupo de recursos que os contém. Você pode excluir o grupo de recursos usando o portal do Azure. Como alternativa, para excluir o grupo de recursos usando a CLI do Azure, use os comandos a seguir:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Próximas etapas

Analisar logs e métricas no plano de consumo padrão e dedicado dos Aplicativos Spring do Azure