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

Von Bedeutung

ASP.NET Core Preview-Versionen mit Azure App Service

ASP.NET Core Preview-Versionen werden standardmäßig nicht für Azure App Service bereitgestellt. Informationen zum Hosten einer App, die eine ASP.NET Core Preview-Version verwendet, finden Sie unter Deploy ASP.NET Core Preview release to Azure App Service.

Informationen zur Problembehandlung eines App Service-Bereitstellungsproblems finden Sie unter "Problembehandlung" ASP.NET Core in Azure App Service und IIS.

Einrichten

Öffnen Sie ein kostenloses Azure-Konto , wenn Sie über keins verfügen.

Erstellen einer Web-App

Starten Sie Visual Studio 2022, und wählen Sie Neues Projekt erstellen aus.

Wählen Sie im Dialogfeld Neues Projekt erstellen die Option ASP.NET Core-Web-App aus, und klicken Sie dann auf Weiter.

Benennen Sie im Dialogfeld " Neues Projekt konfigurieren " Ihr Projekt, und wählen Sie dann "Weiter" aus.

Im Dialogfeld Zusätzliche Informationen:

• Wählen Sie in der Framework-Eingabe.NET 7.0 (Standard Term Support) aus.
• Wählen Sie in der Authentifizierungstypeingabe"Einzelne Konten" und dann " Erstellen" aus.

Visual Studio erstellt die Projektmappe.

App starten

• Drücken Sie F5, um das Projekt auszuführen.

Registrieren eines Benutzers

• Wählen Sie "Registrieren" aus, und registrieren Sie einen neuen Benutzer. Sie können eine fiktive E-Mail-Adresse verwenden. Wenn Sie die Übermittlung ausführen, zeigt die Seite den folgenden Fehler an:

  "Fehler bei einem Datenbankvorgang beim Verarbeiten der Anforderung. Das Problem kann durch das Anwenden vorhandener Migrationen behoben werden"

• Wählen Sie "Migrationen anwenden" aus, und aktualisieren Sie die Seite, sobald die Seite aktualisiert wurde.

• Es wird eine Bestätigungsseite für die Registrierung angezeigt. Klicken Sie hier, um Ihr Konto zu bestätigen.
• Es wird eine Seite "E-Mail bestätigen " angezeigt.
• Melden Sie sich als neuer Benutzer an.

Die App zeigt die E-Mail an, die zum Registrieren des neuen Benutzers und eines Abmeldelinks verwendet wird.

• Beenden Sie die Anwendung, indem Sie den Browser schließen, oder wählen Sie in Visual Studio "Debuggen>beenden" aus.
• Wählen Sie in Visual Studio die Option ">Projektmappe bereinigen", um Projektelemente zu bereinigen und Dateikonflikten zu vermeiden.

Bereitstellen der Anwendung in Azure

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

Im Dialogfeld "Veröffentlichen ":

• Wählen Sie Azure aus.
• Wählen Sie Weiteraus.

Im Dialogfeld "Veröffentlichen ":

• Wählen Sie Azure App Service (Windows) aus.
• Wählen Sie Weiteraus.

Wählen Sie im Dialogfeld " Veröffentlichen " auf der Registerkarte "App Service " die Option "Neu erstellen" aus.

Das Dialogfeld " App Service erstellen " wird angezeigt:

• Die Felder "Name", "Ressourcengruppe" und " Hostingplan " werden aufgefüllt. Sie können diese Namen beibehalten oder ändern.
• Wählen Sie "Erstellen" aus.

Nach Abschluss der Erstellung wird das Dialogfeld automatisch geschlossen, und das Dialogfeld " Veröffentlichen " wird erneut fokussiert:

• Die soeben erstellte neue Instanz wird automatisch ausgewählt.
• Wählen Sie "Fertig stellen" aus.

Das Dialogfeld "Fortschritt der Erstellung des Veröffentlichungsprofils" bestätigt, dass das Veröffentlichungsprofil erstellt wurde. Wählen Sie "Schließen" aus.

Als Nächstes wird die Zusammenfassungsseite "Profil veröffentlichen " angezeigt. Visual Studio hat festgestellt, dass für diese Anwendung eine SQL Server-Datenbank erforderlich ist, die sie im Bereich "Dienstabhängigkeiten" aufgeführt hat. Wählen Sie die Auslassungspunkte (...) und dann "Verbinden" aus.

Das Dialogfeld „Mit Abhängigkeit verbinden“ wird angezeigt:

• Wählen Sie Azure SQL-Datenbank aus.
• Wählen Sie Weiteraus.

Wählen Sie im Dialogfeld "Mit Azure SQL-Datenbank verbinden " die Option "Neu erstellen" aus.

Die Azure SQL-Datenbank erstellen wird angezeigt:

• Die Felder "Datenbankname", "Ressourcengruppe", " Datenbankserver " und " App Service Plan " werden aufgefüllt. Sie können diese Werte beibehalten oder ändern.
• Geben Sie den Benutzernamen des Datenbankadministrators und das Datenbankadministratorkennwort für den ausgewählten Datenbankserver ein (beachten Sie, dass das verwendete Konto über die erforderlichen Berechtigungen zum Erstellen der neuen Azure SQL-Datenbank verfügen muss)
• Wählen Sie "Erstellen" aus.

Nach Abschluss der Erstellung wird das Dialogfeld automatisch geschlossen, und das Dialogfeld "Mit Azure SQL-Datenbank verbinden " erhält erneut den Fokus:

• Die soeben erstellte neue Instanz wird automatisch ausgewählt.
• Wählen Sie Weiteraus.

Im nächsten Schritt des Dialogfelds "Mit Azure SQL-Datenbank verbinden " gehen Sie wie folgt vor:

• Geben Sie den Benutzernamen der Datenbankverbindung und die Felder "Datenbankverbindungskennwort " ein. Dies sind die Details, die Ihre Anwendung zum Herstellen einer Verbindung mit der Datenbank zur Laufzeit verwendet. Es empfiehlt sich, die Verwendung der gleichen Details wie der im vorherigen Schritt verwendete Administratorbenutzername und das Kennwort zu vermeiden.
• Wählen Sie "Fertig stellen" aus.

Das Dialogfeld zum Status der Abhängigkeitskonfiguration bestätigt, dass die Azure SQL-Datenbank konfiguriert ist. Wählen Sie "Schließen" aus.

Wählen Sie auf der Zusammenfassungsseite "Profil veröffentlichen " "Weitere Aktionen>bearbeiten" aus:

Auf der Registerkarte Einstellungen des Dialogfelds Veröffentlichen:

• Erweitern Sie Datenbanken, und aktivieren Sie die Option "Diese Verbindungszeichenfolge zur Laufzeit verwenden".

• Erweitern Sie Entity Framework-Migrationen , und wählen Sie " Diese Migration beim Veröffentlichen anwenden" aus.

• Wählen Sie Speichern aus. Visual Studio kehrt zum Dialogfeld " Veröffentlichen " zurück.

Klicken Sie auf Veröffentlichen. Visual Studio veröffentlicht Ihre App in Azure. Nach Abschluss der Bereitstellung.

Die App wird in einem Browser geöffnet. Registrieren Sie einen neuen Benutzer, und melden Sie sich als neuer Benutzer an, um die Datenbankbereitstellung und Laufzeitverbindung zu überprüfen.

Aktualisieren der App

• Bearbeiten Sie die Pages/Index.cshtmlRazor Seite, und ändern Sie deren Inhalt, und speichern Sie dann die Änderungen. Sie können beispielsweise den Absatz so ändern, dass er "Hello ASP.NET Core!" lautet:

  @page
  @model IndexModel
  @{
      ViewData["Title"] = "Home page";
  }
  
  <div class="text-center">
      <h1 class="display-4">Welcome</h1>
      <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
      <p>Hello ASP.NET Core!</p>
  </div>
  

• Wählen Sie auf der Zusammenfassungsseite "Profil veröffentlichen" erneut die Option "Veröffentlichen" aus.

• Nachdem die App veröffentlicht wurde, aktualisieren Sie die Seite, und überprüfen Sie, ob die von Ihnen vorgenommenen Änderungen in Azure verfügbar sind.

Aufräumen

Wenn Sie die App getestet haben, wechseln Sie zum Azure-Portal , und löschen Sie die App.

• Wählen Sie "Ressourcengruppen" und dann die von Ihnen erstellte Ressourcengruppe aus.

• Wählen Sie auf der Seite " Ressourcengruppe " die Option " Ressourcengruppe löschen" aus.

• Geben Sie den Namen der Ressourcengruppe ein, und wählen Sie "Löschen" aus. Ihre App und alle anderen ressourcen, die in diesem Lernprogramm erstellt wurden, werden jetzt aus Azure gelöscht.

Weitere Ressourcen

• Azure App Service
• Azure-Ressourcengruppen
• Azure SQL-Datenbank
• Visual Studio-Veröffentlichungsprofile (PUBXML) für die Bereitstellung von ASP.NET Core-Apps
• Problembehandlung bei ASP.NET Core in Azure App Service und IIS