Partager via

Démarrage rapide : mapper un domaine personnalisé à Azure Spring Apps avec le plan de consommation et dédié Standard

  • Article

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ✔️ plan de consommation et dédié Standard (préversion) ❌ De base/Standard ❌ Enterprise

Cet article vous montre comment mapper un domaine de site web personnalisé, tel que https://www.contoso.com, à votre application dans Azure Spring Apps. Ce mappage est effectué à l’aide d’un enregistrement CNAME que le service DNS (Domain Name System) utilise pour stocker des noms de nœuds dans l’ensemble du réseau.

Le mappage sécurise le domaine personnalisé avec un certificat et applique le protocole TLS (Transport Layer Security), également connu sous le nom de protocole SSL (Secure Sockets Layer).

Prérequis

Mapper un domaine personnalisé

Pour mapper le domaine personnalisé, vous créez l’enregistrement CNAME, puis utilisez Azure CLI pour lier le domaine à une application dans Azure Spring Apps.

Procédez d’abord comme suit pour créer l’enregistrement CNAME :

  1. Contactez votre fournisseur DNS pour demander un enregistrement CNAME afin de mapper votre domaine au nom de domaine complet (FQDN) de votre application Spring.

  2. Ajoutez un enregistrement TXT avec le nom asuid.{subdomain} dont la valeur est l’ID de vérification de votre environnement Azure Container Apps. Vous pouvez obtenir cette valeur en utilisant la commande suivante.

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

    Après avoir ajouté le CNAME et l’enregistrement TXT, la page d’enregistrements DNS ressemble à la table suivante.

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

  3. Ensuite, liez le domaine personnalisé à votre application en utilisant la commande suivante.

    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>

Nettoyer les ressources

Assurez-vous de supprimer les ressources que vous avez créées dans cet article lorsque vous n’en aurez plus besoin. Pour supprimer les ressources, supprimez simplement le groupe de ressources qui les contient. Vous pouvez supprimer le groupe de ressources à l’aide du portail Azure. Pour supprimer le groupe de ressources à l’aide de l’interface Azure CLI, vous pouvez également utiliser les commandes suivantes :

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

Étapes suivantes

Démarrage rapide – Analyser des journaux et des métriques dans le plan de consommation Standard et dédié Azure Spring Apps