Condividi tramite

Guida introduttiva: Eseguire il mapping di un dominio personalizzato ad App Spring di Azure con il piano a consumo Standard e dedicato

  • Articolo

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a:✅ Utilizzo standard e dedicato (anteprima) ❎ Basic/Standard ❎ Enterprise

Questo articolo illustra come eseguire il mapping di un dominio del sito Web personalizzato, ad esempio https://www.contoso.com, all'app in Azure Spring Apps. Questo mapping viene eseguito usando un CNAME record usato dal servizio DNS (Domain Name Service) per archiviare i nomi dei nodi in tutta la rete.

Il mapping protegge il dominio personalizzato con un certificato e applica Transport Layer Security (TLS), noto anche come Secure Sockets Layer (SSL).

Prerequisiti

  • Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
  • Interfaccia della riga di comando di Azure
  • Un'istanza del servizio piano dedicato e a consumo di Azure Spring Apps Standard.
  • Un'app Spring distribuita in Azure Spring Apps.
  • Un nome di dominio registrato nel Registro DNS, come fornito da un provider di dominio o di hosting Web.
  • Una risorsa certificato creata in un ambiente app Azure Container. Per altre informazioni, vedere Aggiungere un certificato nell'app contenitore.

Eseguire il mapping un dominio personalizzato

Per eseguire il mapping del dominio personalizzato, creare il record CNAME e quindi usare l'interfaccia della riga di comando di Azure per associare il dominio a un'app in Azure Spring Apps.

Prima di tutto, usare la procedura seguente per creare il CNAME record:

  1. Contattare il provider DNS per richiedere un CNAME record per eseguire il mapping del dominio al nome di dominio completo (FQDN) dell'app Spring.

  2. Aggiungere un TXT record con il nome asuid.{subdomain} con il valore corrispondente all'ID di verifica dell'ambiente App Azure Container. È possibile ottenere questo valore usando il comando seguente.

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

    Dopo aver aggiunto il CNAME record e TXT , la pagina record DNS sarà simile alla tabella seguente.

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

  3. Associare quindi il dominio personalizzato all'app usando il comando seguente.

    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>

Pulire le risorse

Assicurarsi di eliminare le risorse create in questo articolo quando non sono più necessarie. Per eliminare le risorse, eliminare semplicemente il gruppo di risorse che li contiene. È possibile eliminare il gruppo di risorse usando il portale di Azure. In alternativa, per eliminare il gruppo di risorse usando l'interfaccia della riga di comando di Azure, usare i comandi seguenti:

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

Passaggi successivi

Analizzare i log e le metriche nel piano a consumo e dedicato di Azure Spring Apps Standard