Guia de início rápido: mapear um domínio personalizado para o Azure Spring Apps com o consumo padrão e o plano dedicado

  • Artigo

Este artigo aplica-se a: ✔️ Consumo padrão e dedicado (Pré-visualização) ❌ Básico/Standard ❌ Enterprise

Este artigo mostra como mapear um domínio de site personalizado, como https://www.contoso.com, para seu aplicativo no Azure Spring Apps. Esse mapeamento é realizado usando um CNAME registro que o DNS (Serviço de Nomes de Domínio) usa para armazenar nomes de nó em toda a rede.

O mapeamento protege o domínio personalizado com um certificado e impõe o Transport Layer Security (TLS), também conhecido como Secure Sockets Layer (SSL).

Pré-requisitos

  • Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
  • CLI do Azure
  • Um consumo padrão do Azure Spring Apps e uma instância de serviço de plano dedicada. Para obter mais informações, consulte Guia de início rápido: provisionar um consumo padrão do Azure Spring Apps e instância de serviço de plano dedicado.
  • Um aplicativo Spring implantado no Azure Spring Apps.
  • Um nome de domínio registrado no registro DNS fornecido por um provedor de hospedagem ou domínio da Web.
  • Um recurso de certificado criado em um ambiente de Aplicativos de Contêiner do Azure. Para obter mais informações, consulte 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 vincular o domínio a um aplicativo no Azure Spring Apps.

Primeiro, use as seguintes etapas para criar o CNAME registro:

  1. Entre em contato com seu provedor de DNS para solicitar um CNAME registro para mapear seu domínio para o FQDN (Nome de Domínio Qualificado Completo) do seu aplicativo Spring.

  2. Adicione um TXT registro com o nome asuid.{subdomain} com o valor sendo a ID de verificação do seu ambiente de 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 CNAME registro e TXT , a página de registros DNS será semelhante à tabela a seguir.

    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>

Clean up resources (Limpar recursos)

Certifique-se de excluir os recursos criados 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 seguintes comandos:

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

Próximos passos

Analise logs e métricas no consumo padrão e plano dedicado do Azure Spring Apps