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

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

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Azure CLI
• Une instance de service de plan de consommation et dédié Standard d’Azure Spring Apps. Pour en savoir plus, consultez Démarrage rapide : approvisionner une instance de service de plan de consommation et dédié Standard d’Azure Spring Apps.
• Une application Spring déployée sur Azure Spring Apps.
• Nom de domaine inscrit dans le registre DNS tel que fourni par un hébergement web ou un fournisseur de domaine.
• Ressource de certificat créée dans un environnement Azure Container Apps. Pour plus d’informations, consultez Ajouter un certificat dans une application conteneur.

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