Mapper des noms DNS à des applications dans plusieurs instances de service Azure Spring Apps du même réseau virtuel

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 au : Niveau ✔️ De base/Standard ✔️ Entreprise

Cet article montre comment mapper des noms DNS (Domain Name System) à des applications pour accéder à plusieurs instances de service Azure Spring Apps au sein du même réseau virtuel.

Prérequis

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Azure CLI version 2.45.0 ou ultérieure. Utilisez la commande suivante pour installer l’extension Azure Spring Apps : az extension add --name spring
• Un réseau virtuel déployé dans une instance d’Azure Spring Apps. Pour plus d’informations, consultez Déployer Azure Spring Apps sur votre réseau virtuel Azure (injection dans le VNet).

Vue d’ensemble

Cet article décrit les deux approches suivantes pour mapper des noms DNS à des applications :

• Utilisation du nom de domaine complet (FQDN) fourni par Microsoft.

  Cette approche est relativement simple et légère à mettre en œuvre pour mapper des noms DNS par rapport à l’approche du domaine personnalisé. Cette approche est recommandée si vous n’avez pas besoin d’une approche basée sur les caractères génériques dans votre zone DNS.

  Cette approche nécessite un enregistrement DNS pour chaque application.

• Utilisation d’un domaine personnalisé.

  Si vous disposez déjà d’un domaine personnalisé, ou si vous souhaitez pouvoir utiliser une approche basée sur les caractères génériques dans un scénario multi-instance, utilisez cette approche.

  Cette approche nécessite un enregistrement DNS pour chaque instance de service Azure Spring Apps ainsi qu’un domaine personnalisé configuré pour chaque application.

Par exemple, cet article utilise azure-spring-apps-1 et azure-spring-apps-2 en tant que noms de deux instances d’Azure Spring Apps dans le même réseau virtuel.

Commencez par la section Étapes préliminaires du mappage DNS, puis poursuivez avec votre approche préférée :

• Mappage DNS avec le FQDN fourni par Microsoft
• Mappage DNS avec un domaine personnalisé

Terminez en testant le mappage, comme indiqué dans la section Accéder à des URL de FQDN privés pour les applications privées.

Étapes préliminaires du mappage DNS

Suivez les étapes de cette section décrivant les approches du FQDN et du domaine personnalisé pour le mappage des noms DNS.

Rechercher des adresses IP d’applications

Les deux approches nécessitent l’adresse IP de chaque application dans l’instance d’Azure Spring Apps à mapper. Suivez les étapes ci-dessous pour rechercher les adresses IP :

Azure portal

1. Accédez au réseau virtuel que vous avez créé pour une instance d’Azure Spring Apps, puis sélectionnez Appareils connectés dans le volet de navigation.

2. Dans la page Appareils connectés, recherchez kubernetes-internal.

3. Dans les résultats de la recherche, recherchez chaque appareil connecté à un sous-réseau de runtime de service d’une instance de service Azure Spring Apps, puis copiez son adresse IP. Dans l’exemple de capture d’écran suivant, l’adresse IP de azure-spring-apps-1 est 10.1.0.6, et l’adresse IP de azure-spring-apps-2 est 10.1.2.6.

   

Azure CLI

1. Utilisez les commandes suivantes afin de définir des variables pour votre abonnement, votre groupe de ressources, votre instance d’Azure Spring Apps et votre réseau virtuel. Personnalisez les valeurs en fonction de votre environnement.

   export SUBSCRIPTION='<subscription-ID>'
   export RESOURCE_GROUP='<resource-group-name>'
   export AZURE_SPRING_APPS_NAME='<Azure-Spring-Apps-instance-name>'
   export VIRTUAL_NETWORK_NAME='<Azure-Spring-Apps-VNET-name>'
   

2. Utilisez les commandes suivantes pour définir les variables du groupe de ressources réseau du runtime de service et de l’adresse IP :

   export SERVICE_RUNTIME_RG=$(az spring show \
       --resource-group $RESOURCE_GROUP \
       --name $AZURE_SPRING_APPS_NAME \
       --query "properties.networkProfile.serviceRuntimeNetworkResourceGroup" \
       --output tsv)
   export IP_ADDRESS=$(az network lb frontend-ip list \
       --lb-name kubernetes-internal \
       --resource-group $SERVICE_RUNTIME_RG \
       --query "[0].privateIpAddress" \
       --output tsv)
   

Créer une zone DNS privée

Suivez les étapes ci-dessous afin de créer une zone DNS privée pour une application dans le réseau privé.

Remarque

Si vous utilisez Microsoft Azure opéré par 21Vianet, remplacez private.azuremicroservices.io par private.microservices.azure.cn dans cet article. Pour plus d’informations, consultez Vérifier les points de terminaison dans Azure.

Azure portal

1. Dans la page d’accueil Azure, recherchez Zones DNS privées.

2. Dans la page Zones DNS privées, sélectionnez Créer.

3. Remplissez le formulaire sur la page Créer une zone DNS privée. Dans Détails de l’instance pour Nom, spécifiez private.azuremicroservices.io en tant que nom de la zone DNS privée.

4. Sélectionnez Vérifier + créer.

5. Sélectionnez Créer.

Azure CLI

1. Utilisez les commandes suivantes pour vous connecter à Azure CLI et définir votre abonnement actif :

   az login
   az account set --subscription ${SUBSCRIPTION}
   

2. Utilisez la commande suivante pour créer la zone DNS privée.

   az network private-dns zone create \
       --resource-group $RESOURCE_GROUP \
       --name private.azuremicroservices.io
   

La création de la zone peut prendre plusieurs minutes.

Lier le réseau virtuel

Pour lier la zone DNS privée que vous avez créée au réseau virtuel, vous devez créer une liaison de réseau virtuel.

Azure portal

Pour créer cette liaison, suivez les étapes ci-dessous :

1. Accédez à la zone DNS privée que vous avez créée, et qui se nomme private.azuremicroservices.io. Plusieurs zones peuvent porter ce nom. Vous devez donc déterminer celle qui convient en fonction de son groupe de ressources et de son abonnement.

2. Dans le volet de navigation, sélectionnez Liaisons de réseau virtuel, puis sélectionnez Ajouter.

3. Pour Nom du lien, entrez azure-spring-apps-dns-link.

4. Pour Réseau virtuel, sélectionnez le réseau virtuel que vous avez créé dans les Prérequis.

   

5. Cliquez sur OK.

Azure CLI

Pour créer cette liaison, utilisez la commande suivante :

az network private-dns link vnet create \
    --resource-group $RESOURCE_GROUP \
    --name azure-spring-apps-dns-link \
    --zone-name private.azuremicroservices.io \
    --virtual-network $VIRTUAL_NETWORK_NAME \
    --registration-enabled false

Affecter un FQDN privé pour vos applications

Affectez un FQDN privé pour votre application.

Azure portal

Suivez les étapes ci-dessous pour mettre à jour votre application avec un point de terminaison affecté :

1. Accédez à l’instance d’Azure Spring Apps déployée sur votre réseau virtuel, puis sélectionnez Applications dans le volet de navigation.

2. Sélectionnez une application.

3. Sélectionnez Attribuer un point de terminaison pour attribuer un nom de domaine complet privé à votre application. L’attribution d’un FQDN peut prendre quelques minutes.

   

4. Répétez ces étapes pour chaque application à mapper.

Azure CLI

Utilisez la commande suivante pour mettre à jour votre application avec un point de terminaison affecté. Personnalisez la valeur du nom de votre application en fonction de votre environnement réel.

export SPRING_CLOUD_APP='<app-name>'
az spring app update \
    --resource-group $RESOURCE_GROUP \
    --name $SPRING_CLOUD_APP \
    --service $SPRING_CLOUD_NAME \
    --assign-endpoint true

Mappage DNS avec un FQDN fourni par Microsoft

Avec cette approche, vous devez créer un enregistrement DNS pour chaque application, ce qui nécessite l’utilisation du nom de domaine complet (FQDN) fourni par Microsoft. Pour une compréhension de l’ensemble de ce processus, consultez Accéder à votre application dans un réseau privé.

Quand une application d’une instance de service Azure Spring Apps avec un point de terminaison affecté est déployée sur le réseau virtuel, le point de terminaison est un FQDN privé. Par défaut, le nom de domaine complet est unique pour chaque application dans les instances de service. Le format du FQDN est le suivant <service-name>-<app-name>.private.azuremicroservices.io.

Créer des enregistrements DNS pour toutes les applications

Pour utiliser la zone DNS privée afin de traduire et de résoudre les noms DNS, vous devez créer un enregistrement de type « A » dans la zone pour chacune de vos applications. Dans cet exemple, le nom de l’application est hello-vnet, et le nom de l’instance de service Azure Springs Apps est azure-spring-apps-1.

Vous avez besoin de l’adresse IP de chaque application. Copiez-la comme indiqué dans la section Rechercher l’adresse IP de votre application, dans Accéder à votre application dans un réseau privé. Dans cet exemple, l’adresse IP est 10.1.0.6.

Azure portal

Suivez les étapes ci-dessous pour créer un enregistrement DNS :

1. Accédez à la zone DNS privée que vous avez créée : private.azuremicroservices.io

2. Sélectionnez Jeu d’enregistrements.

3. Dans le volet Ajouter un jeu d’enregistrements, entrez les valeurs du tableau suivant.

   Paramètre	Valeur
   Nom	azure-spring-apps-1-hello-vnet
   Type	A
   TTL	1
   Unité de durée de vie	Heures
   Adresse IP	(coller à partir du Presse-papiers)

4. Cliquez sur OK.

   

Azure CLI

Utilisez la commande suivante pour créer un enregistrement DNS :

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name 'azure-spring-apps-1-hello-vnet' \
    --ipv4-address $IP_ADDRESS

Répétez ces étapes selon les besoins afin d’ajouter un enregistrement DNS pour d’autres applications.

Mappage DNS avec un domaine personnalisé

Avec cette approche, il vous suffit d’ajouter un enregistrement DNS pour chaque instance d’Azure Spring Apps. Toutefois, vous devez configurer le domaine personnalisé pour chaque application. Pour une compréhension de base de ce processus, consultez Mapper un domaine personnalisé existant à Azure Spring Apps.

Cet exemple réutilise la zone DNS privée private.azuremicroservices.io pour ajouter un enregistrement DNS lié au domaine personnalisé. Le FQDN privé a le format <app-name>.<service-name>.private.azuremicroservices.io.

Techniquement, vous pouvez utiliser n’importe quel nom de domaine complet privé. Dans ce cas, vous devez créer une zone DNS privée correspondant au nom de domaine complet de votre choix.

Mapper votre domaine personnalisé à une application dans une instance d’Azure Spring Apps

Suivez les étapes ci-dessous pour mapper votre domaine personnalisé à chacune des applications de l’instance d’Azure Spring Apps :

Azure portal

1. Ouvrez l’instance d’Azure Spring Apps, puis sélectionnez Applications dans le volet de navigation.

2. Dans la page Applications, sélectionnez une application.

3. Sélectionnez Domaine personnalisé dans le volet de navigation.

4. Sélectionnez Ajouter un domaine personnalisé.

5. Dans le volet Ajouter un domaine personnalisé, entrez le FQDN à utiliser, et vérifiez qu’il correspond au certificat à utiliser plus tard pour la liaison TLS/SSL. Cet exemple utilise hello-vnet.azure-spring-apps-1.private.azuremicroservices.io. Vous pouvez ignorer la partie CNAME.

6. Sélectionnez Valider.

7. Si la validation est réussie, sélectionnez Ajouter.

   

Une fois que le domaine personnalisé est correctement mappé à l’application, il apparaît dans la table des domaines personnalisés.

Azure CLI

1. Utilisez la commande suivante pour lier un domaine personnalisé à une application :

   az spring app custom-domain bind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --domain-name <fqdn-domain-name> \
       --app <app-name>
   

2. Utilisez la commande suivante pour lister tous les domaines personnalisés d’une application :

   az spring app custom-domain list \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --app <app-name> \
   

Remarque

La valeur Non sécurisé sous État TLS/SSL pour votre domaine personnalisé signifie qu’il n’est pas encore lié à un certificat TLS/SSL. Toute requête HTTPS d’un navigateur à votre domaine personnalisé générera une erreur ou un avertissement.

Ajouter une liaison TLS/SSL

Avant d’effectuer cette étape, vérifiez que vous avez préparé vos certificats, et que vous les avez importés dans Azure Spring Apps. Pour plus d’informations, consultez Mapper un domaine personnalisé existant à Azure Spring Apps.

Azure portal

Suivez les étapes ci-dessous pour mettre à jour le domaine personnalisé d’une application à l’aide d’un certificat :

1. Ouvrez l’instance d’Azure Spring Apps, puis sélectionnez Applications dans le volet de navigation.

2. Dans la page Applications, sélectionnez une application.

3. Sélectionnez Domaine personnalisé dans le volet de navigation.

4. Sélectionnez le bouton représentant des points de suspension (...) pour un domaine personnalisé, puis sélectionnez Lier TLS/SSL.

5. Dans le volet Liaison TLS/SSL, sélectionnez Certificat, puis sélectionnez ou importez le certificat.

6. Cliquez sur Enregistrer.

   

Une fois que vous avez réussi à ajouter la liaison TLS/SSL, l’état du domaine est sécurisé, comme le montre la valeur Sain sous État TLS/SSL.

Azure CLI

Utilisez la commande suivante pour mettre à jour le domaine personnalisé d’une application à l’aide d’un certificat :

az spring app custom-domain update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --domain-name <domain-name> \
    --certificate <cert-name> \
    --app <app-name> 

Configurer le domaine personnalisé pour toutes les applications

Pour utiliser la zone DNS privée afin de traduire et de résoudre les noms DNS, vous devez créer un enregistrement de type « A » dans la zone pour chacune de vos instances de service Azure Spring Apps. Dans cet exemple, le nom de l’application est hello-vnet, et le nom de l’instance de service Azure Springs Apps est azure-spring-apps-1.

Vous avez besoin de l’adresse IP de chaque application. Copiez-la comme indiqué dans la section Rechercher l’adresse IP de votre application, dans Accéder à votre application dans un réseau privé. Dans cet exemple, l’adresse IP est 10.1.0.6.

Azure portal

Suivez les étapes ci-dessous pour créer l’enregistrement A dans votre zone DNS :

1. Accédez à la zone DNS privée que vous avez créée : private.azuremicroservices.io

2. Sélectionnez Jeu d’enregistrements.

3. Dans le volet Ajouter un jeu d’enregistrements, entrez les valeurs du tableau suivant.

   Paramètre	Valeur
   Nom	*.azure-spring-apps-1
   Type	A
   TTL	1
   Unité de durée de vie	Heures
   Adresse IP	(coller à partir du Presse-papiers)

4. Cliquez sur OK.

   

Azure CLI

Utilisez la commande suivante pour créer l’enregistrement A dans votre zone DNS :

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name '*.azure-spring-apps-1' \
    --ipv4-address $IP_ADDRESS

Répétez l’opération selon les besoins afin de configurer le domaine personnalisé pour d’autres applications.

Accéder au FQDN privé des applications

Une fois que vous avez effectué les affectations de FQDN et les mappages DNS pour les deux approches, vous pouvez accéder à tous les FQDN privés des applications dans le réseau privé. Par exemple, vous pouvez créer un serveur de rebond (jumpbox) ou une machine virtuelle dans le même réseau virtuel ou dans un réseau virtuel appairé, et avoir accès à tous les FQDN privés des applications.

Les exemples suivants illustrent l’approche FQDN :

• https://hello-vnet.azure-spring-apps-1.private.azuremicroservices.io
• https://hello-vnet.azure-spring-apps-2.private.azuremicroservices.io

Les exemples suivants illustrent l’approche du domaine personnalisé :

• https://azure-spring-apps-1-hello-vnet.private.azuremicroservices.io
• https://azure-spring-apps-2-hello-vnet.private.azuremicroservices.io

La capture d’écran suivante montre l’URL d’une application Spring utilisant un FQDN :

La capture d’écran suivante montre l’URL d’une application Spring utilisant un domaine personnalisé :

Nettoyer les ressources

Si vous prévoyez d’utiliser d’autres articles, vous pouvez conserver ces ressources. Quand vous n’en avez plus besoin, supprimez le groupe de ressources, ce qui supprime également les ressources qu’il contient. Pour supprimer le groupe de ressources à l’aide d’Azure CLI, utilisez la commande suivante :

az group delete --name $RESOURCE_GROUP

Étapes suivantes

• Déployer Azure Spring Apps sur votre réseau virtuel Azure (injection dans le VNet)
• Accéder à votre application sur un réseau privé