Utiliser l’émulateur express pour exécuter et déboguer un service cloud Azure sur une machine locale

Remarque

Cet article s’applique à Azure Cloud Services (classique), qui est désormais déconseillé pour les nouveaux clients et sera mis hors service le 31 août 2024. Les services existants créés avec cette technologie sont toujours pris en charge par le biais d’Azure Cloud Services (support étendu). Pour le nouveau développement, nous vous recommandons d’utiliser un type de service plus récent conçu à des fins spécifiques, comme Azure App Service, Azure Functions ou Azure Container Apps. Pour obtenir la liste la plus récente des services disponibles, consultez le Répertoire des produits Azure.

Avec l’émulateur express, vous testez et déboguez un service cloud sans avoir à exécuter Visual Studio en tant qu’administrateur. Vous pouvez définir les paramètres du projet pour utiliser l’émulateur express ou l’émulateur complet selon la configuration requise de votre service cloud. Pour plus d’informations sur l’émulateur complet, consultez Exécuter une application Azure dans l’émulateur de calcul.

Utiliser l’émulateur express dans Visual Studio

Quand vous créez un projet Azure, l’émulateur express est automatiquement utilisé. Dans le cas des projets existants créés à l’aide d’une version antérieure du Kit SDK Azure, suivez ces étapes pour sélectionner l’émulateur express :

  1. Créez ou ouvrez un projet de service cloud Azure dans Visual Studio.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis, dans le menu contextuel, sélectionnez Propriétés.

  3. Sur les pages de propriétés des projets, sélectionnez l’onglet Web.

    Propriétés pour un projet de service cloud Azure

  4. Sous Serveur de développement local, sélectionnez l’option Utiliser IIS Express.

  5. Sous Émulateur, sélectionnez Utiliser l’émulateur express.

  6. Pour lancer l’émulateur express, exécutez la commande suivante à l’invite de commande :

    csrun.exe /useemulatorexpress

Limitations de l’émulateur express

Les problèmes suivants sont des restrictions connues de l’émulateur express :

  • L’émulateur express n’est pas compatible avec le serveur web IIS.
  • Votre service cloud peut contenir plusieurs rôles, mais chaque rôle est limité à une seule instance.
  • Vous n’avez pas accès aux numéros de port inférieurs à 1 000. Si vous faites appel à un fournisseur d’authentification qui utilise habituellement un numéro de port inférieur à 1000, vous devrez peut-être remplacer cette valeur par un numéro de port supérieur à 1000.
  • Les limitations qui s’appliquent à l’émulateur de calcul Azure s’appliquent aussi à l’émulateur express. Par exemple, il ne peut pas y avoir plus de 50 instances de rôle par déploiement. Pour plus d’informations sur l’émulateur de calcul Azure, consultez la page Exécuter une application Azure dans l’émulateur de calcul.

Débogage d'Azure Cloud Services