Übung: Veröffentlichen einer OpenAPI-fähigen Web-API in Azure App Service

  • 8 Minuten

In dieser Übung stellen Sie Ihre Web-API-Anwendung über Visual Studio für Azure App Service bereit.

Hinweis

In der vorherigen Übung haben Sie bereits die ASP.NET Core-Web-API-App mit aktivierter OpenAPI-Funktion verwendet. Sie verwenden die App für diese Übung.

Sie benötigen ein Azure-Abonnement, um dieses Modul abzuschließen. Wenn Sie keins haben, können Sie sich hier kostenlos registrieren.

Bereitstellen einer Web-API-Anwendung in Azure App Service über Visual Studio

Nach der vorherigen Übung ist die Web-API-Anwendung bereit, veröffentlicht zu werden. Führen Sie die folgenden Schritte aus, um die Web-API-Anwendung bereitzustellen.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie das Menü " Veröffentlichen" aus .

    Klicken Sie in Visual Studio mit der rechten Maustaste auf

  2. Wählen Sie im modalen Dialog "Veröffentlichen " Azure und dann die Schaltfläche " Weiter " aus. (Möglicherweise müssen Sie sich zuerst bei Ihrem Azure-Abonnement anmelden.)

    Wählen Sie

  3. Wählen Sie Azure App Service (Windows) und dann die Schaltfläche "Weiter " aus.

    Wählen Sie

  4. Erstellen wir für diese Übung eine neue Azure App Service-Instanz über Visual Studio. In Zukunft könnten Sie eine vorhandene verwenden. Wählen Sie die ➕ Schaltfläche im Dialog modal aus, um eine neue Azure App Service-Instanz zu erstellen.

    Wählen Sie

  5. Wenn ein neuer modaler Dialog für App Service (Windows) eingeblendt wird, werden alle Feldwerte automatisch ausgefüllt. Sie können die vorab aufgefüllten Daten verwenden oder diese ändern. Füllen Sie alle Feldwerte aus, und wählen Sie die Schaltfläche " Erstellen " aus.

    Neuen App-Dienst erstellen.

  6. Ihre neue Azure App Service-Instanz wurde erstellt. Wählen Sie die Schaltfläche Weiter aus.

    Neuer App-Dienst erstellt.

  7. Veröffentlichen Sie die Web-API-App vorerst nur in der Azure App Service-Instanz . Sie können den Schritt zur Bereitstellung in API Management vorerst überspringen. Aktivieren Sie das Kontrollkästchen "Diesen Schritt überspringen ", und wählen Sie die Schaltfläche " Fertig stellen" aus .

    Fertigstellen des neuen App Service.

  8. Ihre Web-API-App kann bereitgestellt werden. Vergewissern Sie sich im Hauptbereich in den Einstellungen, dass das Zielframework auf Ihre Version von Visual Studio verweist. Wählen Sie die Schaltfläche " Veröffentlichen " in Visual Studio aus.

    Web-API veröffentlichen.

  9. Nachdem die Web-API-App veröffentlicht wurde, benachrichtigt Visual Studio Sie über ein Banner. Kopieren Sie die Website-URL zur späteren Verwendung.

    Web-API veröffentlicht.

Überprüfen, ob die Web-API-Anwendung ausgeführt wird

  1. Stellen Sie sicher, dass Ihre Web-API-App ordnungsgemäß bereitgestellt ist. Öffnen Sie Ihren Webbrowser, und geben Sie die Website-URL ein, die Sie im vorherigen Schritt kopiert haben. Ein Fehler wie "Seite nicht gefunden" wird erwartet, ähnlich wie in der folgenden Abbildung.

    Die Seite wurde nicht gefunden.

  2. Bearbeiten Sie die URL mit /swagger, indem Sie die <copied-website-url> gemäß dem folgenden Beispiel auswählen.

    <copied-website-url>/swagger

  3. Die Seite mit der Swagger-Benutzeroberfläche wird jetzt ordnungsgemäß gerendert. Wählen Sie das Banner "/api/WarehouseLocations " aus, um es zu erweitern.

    Swagger UI-Seite.

  4. Wählen Sie die Schaltfläche "Ausprobieren" aus .

    Swagger UI-Seite – Probieren Sie es aus.

  5. Wählen Sie die Schaltfläche "Ausführen" aus .

    Seite mit der Swagger-Benutzeroberfläche - Execute.

  6. Das Anzeigen des Ergebnisses.

    Seite mit der Swagger-Benutzeroberfläche - Executed.

Herzlichen Glückwunsch! Sie haben nun Ihre ASP.NET Core-Web-API-App in Azure App Service über Visual Studio veröffentlicht!