Exercice : publier une API web OpenAPI sur Azure App Service

  • 8 minutes

Dans cet exercice, vous déployez votre application API web sur Azure App Service par le biais de Visual Studio.

Notes

Dans l’exercice précédent, vous disposez déjà de l’application API web ASP.NET Core avec la fonctionnalité OpenAPI activée. Vous allez utiliser l’application pour cet exercice.

Vous avez besoin d’un abonnement Azure pour suivre ce module. Si vous n’en avez pas, vous pouvez vous inscrire pour bénéficier d’un essai gratuit.

Déployer une application API web pour Azure App Service par le biais de Visual Studio

Après l’exercice précédent, l’application API web est prête à être publiée. Pour déployer l’application API web, exécutez les étapes suivantes.

  1. Dans l’Explorateur de solutions, cliquez avec le bouton de droite et sélectionnez le menu Publier.

    Cliquer avec le bouton droit sur Publier dans Visual Studio.

  2. Dans la boîte de dialogue modale Publier, sélectionnez Azure et sélectionnez le bouton Suivant. (Vous devrez peut-être d’abord vous connecter à votre abonnement Azure.)

    Choisir une cible de publication.

  3. Sélectionnez Azure App Service (Windows) et sélectionnez le bouton Suivant.

    Choisir une cible spécifique.

  4. Nous créons une instance Azure App Service dans Visual Studio pour cet exercice. Par la suite, vous pouvez en utiliser une existante. Sélectionnez le bouton ➕ dans la boîte de dialogue modale pour créer une instance Azure App Service.

    Sélectionnez Créer un App Service.

  5. Quand une nouvelle boîte de dialogue modale App Service (Windows) s’affiche, toutes les valeurs de champ sont déjà remplies automatiquement. Vous pouvez utiliser les champs préremplis ou les modifier. Renseignez toutes les valeurs de champ et sélectionnez le bouton Créer.

    Créer un App Service.

  6. Votre nouvelle instance de Azure App service a été créée. Sélectionnez le bouton Suivant.

    App Service créé.

  7. Pour le moment, nous allons publier l’application API web uniquement sur l’instance Azure App service. Vous pouvez ignorer le déploiement sur Gestion des API pour l’instant. Cochez la case Ignorer cette étape et sélectionnez le bouton Terminer.

    Finir de créer l’App Service.

  8. Votre application API web est prête à être déployée. Dans Paramètres, dans le volet principal, vérifiez que le framework cible référence votre version de Visual Studio. Sélectionnez le bouton Publier dans Visual Studio.

    Publier l’API web.

  9. Une fois l’application API web publiée, Visual Studio vous avertit par le biais d’une bannière. Copiez l’URL du site web pour une utilisation ultérieure.

    API web publiée.

Vérifier que l’application API web est en cours d’exécution

  1. Vérifions maintenant que votre application API web est correctement déployée. Ouvrez votre navigateur web et entrez l’URL du site web que vous avez copiée à l’étape précédente. Une erreur Page introuvable, comme celle de l’image suivante, est attendue.

    Page introuvable.

  2. Modifiez l’URL avec /swagger en sélectionnant <copied-website-url> en fonction de l’exemple suivant.

    <copied-website-url>/swagger

  3. La page d’interface utilisateur Swagger s’affiche désormais correctement. Sélectionnez la bannière /api/WarehouseLocations pour la développer.

    Page de l’IU Swagger.

  4. Sélectionnez le bouton Essayer.

    Page de l’IU Swagger - Essayer.

  5. Sélectionnez le bouton Exécuter.

    Page de l’IU Swagger - Exécuter.

  6. Affichez le résultat.

    Page de l’IU Swagger - Exécutée.

Félicitations ! Vous venez de publier votre application API web ASP.NET Core sur Azure App Service par le biais de Visual Studio !