Veröffentlichen einer ASP.NET Core-App in Azure mit Visual Studio Code

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie eine ASP.Net Core MVC-Anwendung erstellen und diese in Visual Studio Code bereitstellen. Das Tutorial setzt voraus, dass Sie mit Visual Studio Code vertraut sind. Weitere Informationen finden Sie unter Erste Schritte mit Visual Studio Code. Dieses Tutorial kann in Windows-, macOS- oder Linux-Umgebungen genutzt werden. Achten Sie darauf, die richtigen Pfadtrennzeichen (\ gegenüber /) für Ihre Umgebung zu verwenden.

Wichtig

ASP.NET Core-Vorschauversion mit Azure App Service

ASP.NET Core-Vorschauversionen werden nicht standardmäßig in Azure App Service bereitgestellt. Weitere Informationen zum Hosten einer App, die eine ASP.NET Core-Vorschauversion verwendet, finden Sie unter Deploy ASP.NET Core preview release to Azure App Service (Bereitstellen der ASP.NET Core-Vorschauversion in Azure App Service).

Informationen zur Behebung von Problemen bei der App Service-Bereitstellung finden Sie unter Problembehandlung bei ASP.NET Core in Azure App Service und IIS.

Voraussetzungen

Erstellen eines ASP.NET Core MVC-Projekts

  1. Öffnen Sie das integrierte Terminal.

  2. Legen Sie das Verzeichnis, das das Projekt enthält, als Ihr Arbeitsverzeichnis (cd) fest.

  3. Führen Sie die folgenden Befehle aus:

    dotnet new mvc -o MyMVCapp
code -r MyMVCapp

    Die obenstehenden Befehle bewirken Folgendes:

    • dotnet new mvc -o MyMVCapp
      • Erstellt ein neues ASP.NET Core MVC-Projekt im Ordner MyMVCapp.
    • code -r MyMVCapp
      • Lädt die Projektdatei MyMVCapp.csproj in Visual Studio Code.
      • Visual Studio Code aktualisiert das integrierte Terminal auf das Projektverzeichnis.

Hinweis

Möglicherweise wird ein Dialogfeld mit folgender Meldung angezeigt: Die erforderlichen Ressourcen zum Erstellen und Debuggen sind in „MyMVCapp“ nicht vorhanden. Hinzufügen?. Klicken Sie in diesem Fall auf Ja.

Ein neues ASP.NET Core MVC-Projekt wird in einem MyMVCapp-Ordner mit folgender Struktur erstellt:

      appsettings.Development.json
      appsettings.json
<DIR> bin
<DIR> Controllers
<DIR> Models
      MyMVCapp.csproj
<DIR> obj
      Program.cs
<DIR> Properties
<DIR> Views
<DIR> wwwroot

Ein .vscode-Ordner wird in der Projektstruktur erstellt. Er enthält Hilfsprogrammdateien zum Erstellen und Debuggen Ihrer ASP.NET Core-Web-App.

Testen des Projekts

Bevor Sie die App in Azure bereitstellen, sollten Sie sicherstellen, dass sie auf Ihrem lokalen Computer ordnungsgemäß ausgeführt wird.

  1. Öffnen Sie das integrierte Terminal (sofern erforderlich).

  2. Richten Sie ein vertrauenswürdiges HTTPS-Entwicklungszertifikat ein:

    • Vertrauen Sie dem HTTPS-Entwicklungszertifikat, indem Sie den folgenden Befehl ausführen:

      dotnet dev-certs https --trust

      Der oben genannte Befehl funktioniert nicht unter Linux. In der Dokumentation Ihrer Linux-Distribution finden Sie Informationen dazu, wie Sie ein Zertifikat als vertrauenswürdig kennzeichnen.

      Der vorherige Befehl zeigt das folgende Dialogfeld an, sofern das Zertifikat nicht zuvor schon als vertrauenswürdig eingestuft wurde:

      Security warning dialog

    • Klicken Sie auf Ja, wenn Sie zustimmen möchten, dass das Entwicklungszertifikat vertrauenswürdig ist.

      Weitere Informationen finden Sie unter Trust the ASP.NET Core HTTPS development certificate (Festlegen des ASP.NET Core-HTTPS-Entwicklungszertifikats als vertrauenswürdig).

    Informationen dazu, wie Sie dem Firefox-Browser vertrauen, finden Sie unter Firefox-Zertifikatfehler SEC_ERROR_INADEQUATE_KEY_USAGE.

  3. Führen Sie den folgenden Befehl aus:

    dotnet run

    Der vorherige Befehl:

    • Startet Kestrel, integrierter Webserver von ASP.NET Core.
    • Zeigt eine URL an, um die Web-App zu testen, z. B. http://localhost:<port>, wobei <port> die zufällige Portnummer ist, die in Properties\launchSettings.json bei der Projekterstellung festgelegt wird.

    Die Ausgabe zeigt Meldungen ähnlich der folgenden, die angeben, dass die App ausgeführt wird und auf Anforderungen wartet:

    $ dotnet run
Building...
info: Microsoft.Hosting.Lifetime[14]
    Now listening on: https://localhost:7064
info: Microsoft.Hosting.Lifetime[14]
    Now listening on: http://localhost:5119
info: Microsoft.Hosting.Lifetime[0]
    Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
    Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
    Content root path: D:\Src\MyMVCapp\

  4. STRG+Klicken Sie in der Ausgabe auf die HTTPS-URL, um die Web-App in einem Browser zu testen. Im obigen Beispiel ist die URL https://localhost:7064.

  5. Drücken Sie STRG+C im integrierten Terminal, um die Web-App nach dem Testen herunterzufahren.

Bereitstellungspaket lokal generieren

  1. Verwenden Sie im integrierten Terminal den folgenden Befehl, um ein Release-Paket in einem Ordner unter bin/Publish zu generieren:

    dotnet publish -c Release -o ./bin/Publish

    Ein neuer Publish-Unterordner wird im bin-Ordner erstellt. Dieser Ordner enthält die Dateien, die in Azure bereitgestellt werden sollen.

    Publish folder structure

Veröffentlichen in Azure App Service

Nutzen Sie die Azure App Service-Erweiterung für Visual Studio Code, und führen Sie die unten aufgeführten Schritte aus, um die Website direkt in Azure App Service zu veröffentlichen.

Erstellen einer neuen Azure Web App-Ressource

Wenn Sie keine Azure Web App-Ressource zum Veröffentlichen besitzen, müssen Sie eine erstellen.

  1. Erweitern Sie auf der Azure-Erweiterungsregisterkarte im Bereich RESSOURCEN das Abonnement, das Sie verwenden möchten.
  2. Klicken Sie mit der rechten Maustaste auf App Services, und wählen Sie Neue Web App erstellen aus.
  3. Befolgen Sie die Eingabeaufforderungen:
    1. Geben Sie einen eindeutigen Namen für die Web-App ein.
    2. Wählen Sie die neueste stabile .NET-Runtime (z. B. .NET 6 (LTS)) aus. Wählen Sie nicht die ASP.NET-Runtime aus, die für .NET Framework-Apps gilt.
    3. Wählen Sie Ihren Tarif aus. Kostenlos (F1) ist für dieses Tutorial akzeptabel.

Veröffentlichen in Azure

  1. Klicken Sie mit der rechten Maustaste auf den bin\Publish-Ordner, wählen Sie Deploy to Web App... aus, und befolgen Sie die Eingabeaufforderungen.

    1. Wählen Sie das Abonnement aus, in dem sich die Azure Web App-Ressource befindet.
    2. Wählen Sie die Azure Web App-Ressource aus, in der Sie veröffentlichen werden.
    3. Wählen Sie Bereitstellen aus, wenn Sie in einem Bestätigungsdialogfeld dazu aufgefordert werden.

  2. Nachdem die Bereitstellung abgeschlossen ist, klicken Sie auf Browse Website, um die Bereitstellung zu überprüfen.

    Deployment succeeded message

    Durch Klicken auf Browse Website gelangen Sie über Ihren Standardbrowser zur App:

    New Web App successfully deployed

Tipp

Sie können die obigen Schritte wiederholen, um die App nach Bedarf in derselben Azure Web App-Ressource erneut bereitzustellen. Führen Sie vor der Bereitstellung in Azure unbedingt dotnet publish erneut aus.

Nächste Schritte

Zusätzliche Ressourcen