Início Rápido: mapear um domínio personalizado para Aplicativos Spring do Azure com o plano de consumo básico e dedicado
Observação
Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.
O plano consumo e dedicado Standard será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.
Este artigo se aplica a:✅ consumo Standard 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:
Entre em contato com seu provedor DNS para solicitar um registro
CNAMEpara mapear seu domínio para o FQDN (Fully Qualified Domain Name) do aplicativo Spring.Adicione um registro
TXTcom o nomeasuid.{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
CNAMEeTXT, a página de registros DNS será parecida com a seguinte tabela.Nome Tipo Valor {subdomain}CNAMEtestapp.agreeablewater-4c8480b3.eastus.azurecontainerapps.ioasuid.{subdomain}A6K861CL04CATKUCFF604024064D57PB52F5DF7B67BC3033BA9808BDA8998U270Em 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 ..."