Teilen über

Schnellstart: Bereitstellen einer ASP.NET-Web-App

  • Artikel

Hinweis

Ab dem 1. Juni 2024 haben alle neu erstellten App Service-Apps die Möglichkeit, einen eindeutigen Standardhostnamen mit der Namenskonvention <app-name>-<random-hash>.<region>.azurewebsites.net zu erstellen. Vorhandene App-Namen bleiben unverändert.

Beispiel: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Ausführlichere Informationen finden Sie unter Eindeutiger Standardhostname für App Service-Ressourcen.

In dieser Schnellstartanleitung wird beschrieben, wie Sie Ihre erste ASP.NET-Web-App erstellen und für Azure App Service bereitstellen. App Service unterstützt verschiedene Versionen von .NET-Apps und bietet einen hochgradig skalierbaren Webhostingdienst mit Self-Patching. ASP.net Web-Apps sind plattformübergreifend und können unter Linux oder Windows gehostet werden. Am Ende verfügen Sie über eine Azure-Ressourcengruppe, die einen App Service-Hostingplan und eine App Service-Instanz mit einer bereitgestellten Webanwendung umfasst.

Alternativ können Sie eine ASP.NET-Web-App als Teil eines Windows- oder Linux-Containers in App Service bereitstellen.

Tipp

Hier finden Sie Tipps zu GitHub Copilot in den Schritten von Visual Studio, Visual Studio Code und Azure-Portal.

Hinweis

Die Erstellung von .NET 9 (STS)-Apps mit Windows App Service unter Verwendung von MSBuild oder SCM_DO_BUILD wird noch nicht unterstützt. Diese Build-Szenarien werden nach dem ersten GA-Termin und bis zum 4. Dezember 2024 unterstützt. Bereitstellungen, die außerhalb von App Service über Visual Studio, Visual Studio Code, GitHub Actions und Azure DevOps erstellt werden, werden vollständig unterstützt.

Voraussetzungen

Sie haben Visual Studio 2022 bereits installiert:

  1. Installieren Sie in Visual Studio die neuesten Updates, indem Sie Hilfe>Nach Updates suchen auswählen.
  2. Fügen Sie die Workload hinzu. Wählen Sie dazu Tools>Tools und Features abrufen aus.

1. Erstellen einer ASP.NET-Web-App

1. Initialisieren der ASP.NET Web-App-Vorlage

  1. Öffnen Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.

  2. Suchen Sie unter Neues Projekt erstellen die Option ASP.NET Core-Web-App (Razor Pages), und wählen Sie sie aus. Wählen Sie anschließend Weiter aus.

  3. Geben Sie der Anwendung unter Neues Projekt konfigurieren den Namen MyFirstAzureWebApp, und wählen Sie dann Weiter aus.

    Screenshot von Visual Studio: Konfigurieren einer ASP.NET 8.0-Web-App.

  4. Wählen Sie .NET 8.0 (Langfristiger Support) aus.

  5. Stellen Sie sicher, dass der Authentifizierungstyp auf Keine festgelegt ist. Klicken Sie auf Erstellen.

    Screenshot von Visual Studio: Zusätzliche Informationen bei der Auswahl von .NET 8.0.

  6. Wählen Sie im Visual Studio-Menü Debuggen>Starten ohne Debugging aus, um die Web-App lokal auszuführen. Wenn eine Meldung angezeigt wird, in der Sie aufgefordert werden, einem selbstsignierten Zertifikat zu vertrauen, wählen Sie Ja aus.

    Screenshot von Visual Studio: ASP.NET Core 8.0 wird lokal ausgeführt.

Tipp

Wenn Sie über ein GitHub Copilot-Konto verfügen, versuchen Sie, GitHub Copilot-Features für Visual Studio zu erhalten.

  1. Öffnen Sie auf Ihrem Computer in einem Arbeitsverzeichnis ein Terminalfenster. Erstellen Sie mit dem Befehl dotnet new webapp eine neue .NET-Web-App, und ändern Sie dann die Verzeichnisse in der neu erstellten App.

    dotnet new webapp -n MyFirstAzureWebApp --framework net8.0
cd MyFirstAzureWebApp

  2. Führen Sie die Anwendung aus derselben Terminalsitzung mithilfe des Befehls dotnet run lokal aus.

    dotnet run --urls=https://localhost:5001/

  3. Öffnen Sie einen Webbrowser, und navigieren Sie zu der App auf https://localhost:5001.

    Die Vorlage für die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot von Visual Studio Code: ASP.NET Core 8.0 im lokalen Browser.

In diesem Schritt forken Sie ein Demoprojekt für die Bereitstellung.

  1. Wechseln Sie zur .NET 8.0-Beispiel-App.
  2. Wählen Sie die Schaltfläche Fork oben rechts auf der GitHub-Seite aus.
  3. Wählen Sie den Besitzer aus, und belassen Sie den standardmäßigen Repositorynamen.
  4. Wählen Sie Create fork (Fork erstellen) aus.

In dieser Schnellstartanleitung wird die Azure Developer CLI (azd) verwendet, um Azure-Ressourcen zu erstellen und Code dafür bereitzustellen. Weitere Informationen zur Azure Developer CLI finden Sie in der Dokumentation oder im Schulungspfad.

Rufen Sie die ASP.NET Core-Web-App-Vorlage für diese Schnellstartanleitung mit den folgenden Schritten ab, und initialisieren Sie sie:

  1. Öffnen Sie auf Ihrem Computer in einem leeren Arbeitsverzeichnis ein Terminalfenster. Initialisieren Sie die azd-Vorlage mithilfe des Befehls azd init.

    azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git

    Wenn Sie aufgefordert werden, einen Umgebungsnamen einzugeben, geben Sie dev ein.

  2. Führen Sie die Anwendung aus derselben Terminalsitzung mithilfe des Befehls dotnet run lokal aus. Verwenden Sie den --project-Parameter, um das src-Verzeichnis der azd-Vorlage anzugeben, in dem sich der Anwendungscode befindet.

    dotnet run --project src --urls=https://localhost:5001/

  3. Öffnen Sie einen Webbrowser, und navigieren Sie zur App unter https://localhost:5001. Die ASP.NET Core 8.0-Web-App-Vorlage wird auf der Seite angezeigt.

    Screenshot von Visual Studio Code: ASP.NET Core 8.0 im lokalen Browser.

2. Veröffentlichen der Web-App

Führen Sie die folgenden Schritte aus, um Ihre App Service-Ressourcen zu erstellen und Ihr Projekt zu veröffentlichen:

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

  2. Wählen Sie unter Veröffentlichen die Option Azure aus, und klicken Sie dann auf Weiter.

    Screenshot von Visual Studio: Web-App veröffentlichen und auf Azure abzielen.

  3. Wählen Sie als Spezifisches Ziel entweder Azure App Service (Linux) oder Azure App Service (Windows) aus. Klicken Sie anschließend auf Weiter.

    Wichtig

    Wenn Sie ASP.NET Framework 4.8 als Ziel auswählen, verwenden Sie Azure App Service (Windows) .

  4. Ihre Optionen hängen davon ab, ob Sie bereits bei Azure angemeldet sind und ob Sie über ein Visual Studio-Konto verfügen, das mit einem Azure-Konto verknüpft ist. Wählen Sie entweder Konto hinzufügen oder Anmelden aus, um sich bei Ihrem Azure-Abonnement anzumelden. Wenn Sie bereits angemeldet sind, wählen Sie das gewünschte Konto aus.

    Screenshot von Visual Studio: Dialogfeld „Bei Azure anmelden“ auswählen.

  5. Wählen Sie rechts von App Service-Instanzen die Option + aus.

    Screenshot von Visual Studio: Dialogfeld „Neue App Service-App“.

  6. Akzeptieren Sie unter Abonnement das angegebene Abonnement, oder wählen Sie in der Dropdownliste ein neues Abonnement aus.

  7. Wählen Sie unter Ressourcengruppe die Option Neu aus. Geben Sie unter Name der neuen Ressourcengruppe den Namen myResourceGroup ein, und wählen Sie OK aus.

  8. Wählen Sie unter Hostingplan die Option Neu aus.

  9. Geben Sie im Dialogfeld Hostingplan: Neu erstellen die Werte ein, die in der folgenden Tabelle angegeben sind:

    Einstellung Vorgeschlagener Wert Beschreibung
    Hostingplan MyFirstAzureWebAppPlan Name des App Service-Plans.
    Location Europa, Westen Das Rechenzentrum, in dem die Web-App gehostet wird.
    Größe Wählen Sie die unterste Ebene aus. Preisstufen definieren Hostingfeatures.

  10. Geben Sie unter Name einen eindeutigen App-Namen ein, der nur aus den folgenden zulässigen Zeichen besteht: a-z, A-Z, 0-9 und -. Sie können den automatisch generierten eindeutigen Namen übernehmen. Die URL der Web-App lautet http://<app-name>.azurewebsites.net, wobei <app-name> der Name Ihrer App ist.

  11. Wählen Sie Erstellen aus, um die Azure-Ressourcen zu erstellen.

    Screenshot von Visual Studio: Dialogfeld „App Ressourcen erstellen“.

    Nach dem Abschluss des Assistenten werden die Azure-Ressourcen für Sie erstellt, und Sie können Ihr ASP.NET Core-Projekt veröffentlichen.

  12. Vergewissern Sie sich im Dialogfeld Veröffentlichen, dass Ihre App Service-App ausgewählt ist, und wählen Sie dann Fertig stellen und Schließen aus. Visual Studio erstellt ein Veröffentlichungsprofil für die ausgewählte App Service-App.

  13. Wählen Sie auf der Seite Veröffentlichen die Option Veröffentlichen aus. Wenn eine Warnmeldung angezeigt wird, klicken Sie auf Weiter.

    Visual Studio erstellt, packt und veröffentlicht die App in Azure und startet sie anschließend im Standardbrowser.

    Die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot von Visual Studio: ASP.NET Core 8.0-Web-App in Azure.

  1. Öffnen Sie Visual Studio Code aus dem Stammverzeichnis Ihres Projekts.

    code .

  2. Wählen Sie Ja, ich vertraue den Autoren aus, wenn Sie dazu aufgefordert werden.

    Tipp

    Wenn Sie über ein GitHub Copilot-Konto verfügen, versuchen Sie, GitHub Copilot-Features für Visual Studio Code zu erhalten.

  3. Öffnen Sie in Visual Studio Code die Befehlspalette, indem Sie Ansicht>Befehlspalette auswählen.

  4. Suchen Sie nach „Azure App Service: Neue Web-App erstellen (Erweitert)“, und wählen Sie es aus.

  5. Gehen Sie bei den Aufforderungen wie folgt vor:

    1. Melden Sie sich nach Aufforderung bei Ihrem Azure-Konto an.
    2. Wählen Sie Ihr Abonnement aus.
    3. Wählen Sie Neue Web-App erstellen... Erweitert aus.
    4. Verwenden Sie bei Geben Sie einen global eindeutigen Namen ein einen Namen, der in ganz Azure eindeutig ist (zulässig sind die Zeichen a-z, 0-9 sowie - ). Ein bewährtes Muster ist eine Kombination aus Ihrem Firmennamen und einer App-ID.
    5. Wählen Sie Neue Ressourcengruppe erstellen aus, und geben Sie einen Namen ein, z. B. myResourceGroup.
    6. Wenn Sie zum Auswählen eines Laufzeitstapels aufgefordert werden, wählen Sie .NET 8 (STS) aus.
    7. Wählen Sie ein Betriebssystem (Windows oder Linux) aus.
    8. Wählen Sie einen Ort in Ihrer Nähe aus.
    9. Klicken Sie auf Neuen App Service-Plan erstellen, geben Sie einen Namen an, und wählen Sie dann den Tarif Free (F1) aus.
    10. Wählen Sie für die Application Insights-Ressource die Option Vorerst überspringen aus.
    11. Wenn Sie dazu aufgefordert werden, wählen Sie Bereitstellen aus.
    12. Wählen Sie MyFirstAzureWebApp als Ordner für die Bereitstellung aus.
    13. Wählen Sie nach Aufforderung die Option Konfiguration hinzufügen aus.

  6. Wählen Sie im Popupfenster Immer den Arbeitsbereich „MyFirstAzureWebApp“ unter „<App-Name>“ bereitstellen die Option Ja aus, damit Visual Studio Code jedes Mal, wenn Sie sich in diesem Arbeitsbereich befinden, in derselben App Service-App bereitstellt.

  7. Wenn die Veröffentlichung abgeschlossen ist, wählen Sie in der Benachrichtigung Website durchsuchen aus, und wählen Sie bei entsprechender Aufforderung Öffnen.

    Die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot von Visual Studio Code: ASP.NET Core 8.0-Web-App in Azure.

  1. Melden Sie sich mithilfe des Befehls az login bei Ihrem Azure-Konto an, und folgen Sie der Eingabeaufforderung:

    az login
    • Wenn der Befehl az nicht erkannt wird, stellen Sie sicher, dass Sie die Azure CLI gemäß der Beschreibung im Abschnitt Voraussetzungen installiert haben.

  2. Stellen Sie den Code mit dem Befehl az webapp up in Ihrem lokalen Verzeichnis MyFirstAzureWebApp bereit:

    az webapp up --sku F1 --name <app-name> --os-type <os>
    • Ersetzen Sie <app-name> durch einen Namen, der innerhalb von Azure eindeutig ist (gültige Zeichen: a-z, 0-9 und - ). Ein bewährtes Muster ist eine Kombination aus Ihrem Firmennamen und einer App-ID.
    • Mit dem Argument --sku F1 wird die Web-App im Tarif Free erstellt. Lassen Sie dieses Argument weg, um einen schnelleren Premium-Tarif zu verwenden. Dieser verursacht jedoch stündlich Kosten.
    • Ersetzen Sie <os> entweder durch linux oder durch windows.
    • Optional können Sie das Argument --location <location-name> einfügen, wobei <location-name> eine verfügbare Azure-Region ist. Sie können eine Liste der zulässigen Regionen für Ihr Azure-Konto abrufen, indem Sie den Befehl az account list-locations ausführen.

    Die Ausführung des Befehls kann einige Minuten dauern. Während der Ausführung gibt der Befehl Meldungen über die Erstellung der Ressourcengruppe, des App-Service-Plans und der Hosting-App aus, konfiguriert die Protokollierung und führt dann die ZIP-Bereitstellung durch. Anschließend wird eine Meldung mit der URL der App angezeigt:

    You can launch the app at http://<app-name>.azurewebsites.net

  3. Öffnen Sie einen Webbrowser, und navigieren Sie zu der URL.

    Die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot der CLI: ASP.NET Core 8.0-Web-App in Azure.

Hinweis

Zum Erstellen von Apps auf der Windows-Hostingplattform wird Azure PowerShell empfohlen. Verwenden Sie zum Erstellen von Apps unter Linux ein anderes Tool, etwa die Azure CLI.

  1. Melden Sie sich mithilfe des Befehls Connect-AzAccount bei Ihrem Azure-Konto an, und folgen Sie der Eingabeaufforderung:

    Connect-AzAccount

  1. Erstellen Sie mithilfe des Befehls New-AzWebApp eine neue App.

    New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
    • Ersetzen Sie <app-name> durch einen Namen, der innerhalb von Azure eindeutig ist (gültige Zeichen: a-z, 0-9 und - ). Ein bewährtes Muster ist eine Kombination aus Ihrem Firmennamen und einer App-ID.
    • Optional können Sie den Parameter -Location <location-name> einfügen, wobei <location-name> eine verfügbare Azure-Region ist. Sie können eine Liste der zulässigen Regionen für Ihr Azure-Konto abrufen, indem Sie den Befehl Get-AzLocation ausführen.

    Die Ausführung des Befehls kann einige Minuten dauern. Während der Ausführung erstellt der Befehl eine Ressourcengruppe, ein App Service-Plan und die App Service-Ressource.

  2. Bereiten Sie im Stammordner der Anwendung die lokale Anwendung MyFirstAzureWebApp mithilfe des Befehls dotnet publish auf die Bereitstellung vor:

    dotnet publish --configuration Release

  3. Wechseln Sie zum Releaseverzeichnis, und erstellen Sie aus dem Inhalt eine ZIP-Datei:

    cd bin\Release\net8.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip

  4. Veröffentlichen Sie die ZIP-Datei mit dem Befehl Publish-AzWebApp in der Azure-App:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    Hinweis

    -ArchivePath benötigt den vollständigen Pfad der ZIP-Datei.

  5. Öffnen Sie einen Webbrowser, und navigieren Sie zu der URL.

    Die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot der CLI: ASP.NET Core 8.0-Web-App in Azure.

  1. Geben Sie app services in das Suchfeld ein. Wählen Sie unter Dienste die Option App Services aus.

    Screenshot der Portalsuche im Azure-Portal.

  2. Wählen Sie auf der Seite App Services Erstellen>Web App aus.

  3. Auf der Registerkarte Grundlagen:

    • Wählen Sie unter Ressourcengruppe die Option Neu erstellen aus. Geben Sie als Namen myResourceGroup ein.
    • Geben Sie unter Name einen global eindeutigen Namen für Ihre Web-App ein.
    • Wählen Sie unter Veröffentlichen die Option Code aus.
    • Wählen Sie unter Runtimestapel die Option .NET 8 (LTS) aus.
    • Wählen Sie unter Betriebssystem die Option Windows aus. Wenn Sie Linux auswählen, können Sie die GitHub-Bereitstellung im nächsten Schritt nicht konfigurieren. Sie können dies aber dennoch tun, nachdem Sie die App im Deployment Center-Seite erstellt haben.
    • Wählen Sie eine Region aus, aus der Sie Ihre App bereitstellen möchten.
    • Wählen Sie unter App Service Plan die Option Neu erstellen aus, und geben Sie als Namen myAppServicePlan ein.
    • Wählen Sie unter Tarif die Option Free F1 aus.

    Screenshot der neuen Konfiguration der App Service-App für .NET 8 im Azure-Portal.

  4. Wählen Sie oben auf der Seite die Registerkarte Bereitstellung aus

  5. Legen Sie unter GitHub-Aktionen-Einstellungen die Option Fortlaufende Bereitstellung auf Aktivieren fest.

  6. Authentifizieren Sie sich unter GitHub Actions-Details mit Ihrem GitHub-Konto, und wählen Sie die folgenden Optionen aus:

    • Wählen Sie als Organisation die Organisation aus, in der Sie das Demoprojekt geforkt haben.
    • Wählen Sie als Repository das dotnetcore-docs-hello-world-Projekt aus.
    • Wählen Sie in Branch die Option Hauptbereich aus.

    Screenshot des Bereichs „Bereitstellungsoptionen“ für eine App, welche die .NET 8-Runtime verwendet.

    Hinweis

    Standardmäßig deaktiviert der Erstellungsassistent die Basisauthentifizierung und die Bereitstellung von GitHub Actions wird mit einer dem Benutzer zugewiesenen Identität erstellt. Wenn Sie während der Ressourcenerstellung einen Berechtigungsfehler erhalten, verfügt Ihr Azure-Konto möglicherweise nicht über ausreichende Berechtigungen. Sie können die Bereitstellung von GitHub-Aktionen später mit einer Identität konfigurieren, die von einem Azure-Administrator generiert wird, oder Sie können stattdessen auch die Standardauthentifizierung aktivieren.

  7. Wählen Sie unten auf der Seite die Schaltfläche Überprüfen und erstellen aus.

  8. Wählen Sie nach der Überprüfung unten auf der Seite die Schaltfläche Erstellen aus.

  9. Wenn Ihre Bereitstellung abgeschlossen ist, wählen Sie Go to resource (Zu Ressource wechseln) aus.

    Screenshot: Nächster Schritt zum Navigieren zur Ressource.

  10. Navigieren Sie in Ihrem Webbrowser zur an der URL http://<app-name>.azurewebsites.net bereitgestellten Anwendung. Wenn die Meldung „Ihre Web-App wird ausgeführt und wartet auf Ihre Inhalte“ angezeigt wird, wird die GitHub-Bereitstellung weiterhin ausgeführt. Warten Sie ein paar Minuten und aktualisieren Sie die Seite.

Die AZD-Vorlage enthält Dateien, welche die folgenden erforderlichen Ressourcen generieren, damit Ihre Anwendung in App Service ausgeführt werden kann:

  • Eine neue Ressourcengruppe, die alle Azure-Ressourcen für den Dienst enthalten soll.
  • Ein neuer App Service-Plan, der den Standort, die Größe und die Funktionen der Webserverfarm angibt, die Ihre App hostet.
  • Eine neue App Service-App-Instanz, um die bereitgestellte Anwendung auszuführen.

  1. Melden Sie sich mithilfe des Befehls azd auth login bei Ihrem Azure-Konto an, und folgen Sie der Eingabeaufforderung:

    azd auth login

  2. Erstellen Sie die Azure-Ressourcen, und stellen Sie Ihre App mithilfe des Befehls azd up bereit:

    azd up

    Die Ausführung des Befehls azd up kann einige Minuten dauern. azd up verwendet die Bicep-Dateien in Ihren Projekten, um die Ressourcengruppe, den App Service Plan und die Hosting-App zu erstellen. Es führt auch bestimmte Konfigurationen aus, z. B. das Aktivieren der Protokollierung, und stellt Ihren kompilierten App-Code bereit. Während der Ausführung stellt der Befehl Nachrichten zum Bestimmungs- und Bereitstellungsprozess bereit, einschließlich eines Links zur Bereitstellung in Azure. Wenn er abgeschlossen ist, zeigt der Befehl auch einen Link zur Bereitstellungsanwendung an.

  3. Öffnen Sie einen Webbrowser, und navigieren Sie zu der URL.

    Die ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot der bereitgestellten .NET Framework 4.8-Beispiel-App.

3. Aktualisieren der App und erneute Bereitstellung

Sie nehmen eine Änderung an Index.cshtml vor und stellen sie erneut bereit, um die Änderungen anzuzeigen. In der .NET 8.0-Vorlage, die sich im Ordner Pages befindet. In der .NET Framework 4.8-Vorlage befindet sie sich im Ordner Ansichten/Start. Führen Sie die folgenden Schritte aus, um Ihre Web-App zu aktualisieren und erneut bereitzustellen:

  1. Öffnen Sie im Projektmappen-Explorer unter Ihrem Projekt die Datei Index.cshtml.

  2. Ersetzen Sie das erste <div>-Element durch den folgenden Code:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Tipp

    Wenn GitHub Copilot in Visual Studio aktiviert ist, probieren Sie Folgendes aus:

    1. Wählen Sie das <div>-Element aus und geben Sie Alt+/ ein.
    2. Fordern Sie Copilot auf: „Wechsel zu einer Bootstrap-Karte, die .NET 💜 Azure anzeigt.“

    Speichern Sie die Änderungen.

  3. Klicken Sie zur erneuten Bereitstellung in Azure im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt MyFirstAzureWebApp, und wählen Sie Veröffentlichen aus.

  4. Wählen Sie auf der Zusammenfassungsseite Veröffentlichen die Option Veröffentlichen aus.

    Nach Abschluss der Veröffentlichung wird in Visual Studio ein Browser mit der URL der Web-App gestartet.

    Die aktualisierte ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot von Visual Studio: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

  1. Öffnen Sie Pages/Index.cshtml.

  2. Ersetzen Sie das erste <div>-Element durch den folgenden Code:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Tipp

    Probieren Sie dies mit GitHub Copilot aus:

    1. Wählen Sie das gesamte <div>-Element aus und klicken Sie auf .
    2. Fordern Sie Copilot auf: „Wechsel zu einer Bootstrap-Karte, die .NET 💜 Azure anzeigt.“

    Speichern Sie die Änderungen.

  3. Öffnen Sie in Visual Studio Code die BefehlspaletteSTRG++UMSCHALT++P.

  4. Suchen Sie „Azure App Service: „In Web-App bereitstellen“ aus.

  5. Wählen Sie das Abonnement und die Web-App aus, die Sie zuvor verwendet haben.

  6. Wenn Sie dazu aufgefordert werden, wählen Sie Bereitstellen aus.

  7. Wenn die Veröffentlichung abgeschlossen ist, wählen Sie Website durchsuchen in der Benachrichtigung aus.

    Die aktualisierte ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot von Visual Studio Code: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

Tipp

Informationen dazu, wie Visual Studio Code mit GitHub Copilot hilft, Ihre Webentwicklung zu verbessern, finden Sie in den Visual Studio Code-Schritten.

Öffnen Sie im lokalen Verzeichnis die Datei Pages/Index.cshtml. Ersetzen Sie das erste <div>-Element:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Speichern Sie Ihre Änderungen, stellen Sie die App dann erneut mit dem Befehl az webapp up zur Anwendung bereit, und ersetzen Sie <os> durch linux oder windows.

az webapp up --os-type <os>

In diesem Befehl werden lokal zwischengespeicherte Werte aus der Datei .azure/config verwendet (einschließlich App-Name, Ressourcengruppe und App Service-Plan).

Wechseln Sie nach Abschluss der Bereitstellung wieder zu dem Browserfenster, das im Schritt Navigieren zur App geöffnet wurde, und wählen Sie die Option „Aktualisieren“ aus.

Die aktualisierte ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

Screenshot der CLI: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

  1. Öffnen Sie im lokalen Verzeichnis die Datei Pages/Index.cshtml. Ersetzen Sie das erste <div>-Element:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

  2. Bereiten Sie im Stammordner der Anwendung die lokale Anwendung MyFirstAzureWebApp mithilfe des Befehls dotnet publish auf die Bereitstellung vor:

    dotnet publish --configuration Release

  3. Wechseln Sie zum Releaseverzeichnis, und erstellen Sie aus dem Inhalt eine ZIP-Datei:

    cd bin\Release\net8.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip

  4. Veröffentlichen Sie die ZIP-Datei mit dem Befehl Publish-AzWebApp in der Azure-App:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    Hinweis

    -ArchivePath benötigt den vollständigen Pfad der ZIP-Datei.

  5. Wechseln Sie nach Abschluss der Bereitstellung wieder zu dem Browserfenster, das im Schritt Navigieren zur App geöffnet wurde, und wählen Sie die Option „Aktualisieren“ aus.

    Die aktualisierte ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot der CLI: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

  1. Navigieren Sie zu Ihrem GitHub-Fork des Beispielcodes.

  2. Erstellen Sie auf der Repositoryseite einen Codespace, indem Sie Code>Codespace auf Main erstellen.

    Tipp

    Wenn Sie über ein GitHub Copilot-Konto verfügen, versuchen Sie, GitHub Copilot-Features in Ihrem Codespace zu erhalten.

  3. Öffnen Sie Index.cshtml.

    „Index.cshtml“ befindet sich im Ordner Pages.

    Screenshot des Explorer-Fensters aus Visual Studio Code im Browser, worin „Index.cshtml“ im „dotnetcore-docs-hello-world“-Repository hervorgehoben ist.

  4. Ersetzen Sie das erste <div>-Element durch den folgenden Code:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Die Änderungen werden automatisch gespeichert.

    Tipp

    Probieren Sie dies mit GitHub Copilot aus:

    1. Wählen Sie das gesamte <div>-Element aus und klicken Sie auf .
    2. Fordern Sie Copilot auf: „Wechsel zu einer Bootstrap-Karte, die .NET 💜 Azure anzeigt.“

  5. Geben Sie im Menü Quellcodeverwaltung eine Commitnachricht wie Modify homepage ein. Wählen Sie dann Commit aus und bestätigen Sie das Staging der Änderungen, indem Sie Ja auswählen.

    Tipp

    Lassen Sie GitHub Copilot eine Commit-Nachricht für Sie erstellen, indem Sie im Meldungsfeld auswählen.

  6. Wählen Sie Synchronisierungsänderungen 1 aus und bestätigen Sie dann, indem Sie OK auswählen.

  7. Es dauert einige Minuten, bis die Bereitstellung ausgeführt wird. Um den Fortschritt anzuzeigen, navigieren Sie zu https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.

  8. Kehren Sie zum Browserfenster zurück, das während des Schrittes Zu der App navigieren geöffnet wurde, und aktualisieren Sie die Seite.

    Die aktualisierte ASP.NET Core 8.0-Web-App wird auf der Seite angezeigt.

    Screenshot der CLI: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

Öffnen Sie im lokalen Verzeichnis die Datei src/Pages/Index.cshtml. Ersetzen Sie das erste <div>-Element:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Speichern Sie Ihre Änderungen, und stellen Sie die App dann mit dem Befehl azd up erneut bereit:

azd up

azd up überspringt diesmal den Schritt zur Bereitstellung von Ressourcen und stellt Ihren Code nur erneut bereit, da keine Änderungen an den Bicep-Dateien vorgenommen wurden.

Nach Abschluss der Bereitstellung wird der Browser mit der aktualisierten ASP.NET Core 8.0-Web-App geöffnet.

Screenshot der CLI: Aktualisierte ASP.NET Core 8.0-Web-App in Azure.

4. Verwalten der Azure-App

Wechseln Sie zum Verwalten Ihrer Web-App zum Azure-Portal, und suchen Sie nach App Services. Wählen Sie diese Option anschließend aus.

Screenshot des Azure-Portals: Option „App Services auswählen“.

Wählen Sie auf der Seite App Services den Namen Ihrer Web-App aus.

Screenshot des Azure-Portals: Seite „App Services“ mit einer ausgewählten Beispiel-Web-App.

Die Seite Übersicht für Ihre Web-App enthält Optionen für die grundlegende Verwaltung, z. B. Durchsuchen, Beenden, Starten, Neustarten und Löschen. Im linken Menü können Sie auf weitere Seiten für die Konfiguration Ihrer App zugreifen.

Screenshot des Azure-Portals: Übersichtsseite von App Service.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

  1. Wählen Sie auf der Seite „Übersicht“ Ihrer Web-App im Azure-Portal den Link myResourceGroup unter Ressourcengruppe aus.
  2. Vergewissern Sie sich, dass es sich bei den auf der Seite „Ressourcengruppe“ aufgeführten Ressourcen wirklich um die Ressourcen handelt, die gelöscht werden sollen.
  3. Wählen Sie die Option Löschen aus, geben Sie im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.
  4. Bestätigen Sie erneut, indem Sie Löschen auswählen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

  1. Wählen Sie auf der Seite „Übersicht“ Ihrer Web-App im Azure-Portal den Link myResourceGroup unter Ressourcengruppe aus.
  2. Vergewissern Sie sich, dass es sich bei den auf der Seite „Ressourcengruppe“ aufgeführten Ressourcen wirklich um die Ressourcen handelt, die gelöscht werden sollen.
  3. Wählen Sie die Option Löschen aus, geben Sie im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.
  4. Bestätigen Sie erneut, indem Sie Löschen auswählen.

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, löschen Sie die Ressourcengruppe, indem Sie den folgenden Befehl in Cloud Shell ausführen:

az group delete

Aus Gründen der Einfachheit speichert der az webapp up-Befehl, den Sie zuvor in diesem Projekt ausgeführt haben, den Ressourcengruppennamen als Standardwert, wenn Sie az-Befehle aus diesem Projekt ausführen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen voraussichtlich nicht mehr benötigen, löschen Sie die Ressourcengruppen mit folgendem PowerShell-Befehl:

Remove-AzResourceGroup -Name myResourceGroup

Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

  1. Wählen Sie auf der Seite „Übersicht“ Ihrer Web-App im Azure-Portal den Link myResourceGroup unter Ressourcengruppe aus.
  2. Vergewissern Sie sich, dass es sich bei den auf der Seite „Ressourcengruppe“ aufgeführten Ressourcen wirklich um die Ressourcen handelt, die gelöscht werden sollen.
  3. Wählen Sie die Option Löschen aus, geben Sie im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.
  4. Bestätigen Sie erneut, indem Sie Löschen auswählen.

Bereinigen von Ressourcen

Verwenden Sie den Befehl azd down, um die Ressourcengruppe und alle zugehörigen Ressourcen zu entfernen:

azd down

Die nächsten Schritte zum Arbeiten mit azd-Vorlagen und zusätzlichen Features finden Sie in der Azure Developer CLI-Dokumentation.

Nächste Schritte

Fahren Sie mit dem nächsten Artikel fort, um sich darüber zu informieren, wie Sie eine .NET Core-App erstellen und dafür eine Verbindung mit einer SQL-Datenbank herstellen:

Tutorial: ASP.NET Core-App mit SQL-Datenbank

App-Vorlage: ASP.NET Core-App mit SQL-Datenbank und App Insights, die mithilfe von CI/CD GitHub Actions bereitgestellt wurden

Konfigurieren der ASP.NET Core-App

Weitere Informationen zur Azure Developer CLI