Freigeben über


Schnellstart: Bereitstellen einer ASP.NET-Web-App

Hinweis

Seit dem 1. Juni 2024 können neu erstellte App Service-Apps einen eindeutigen Standardhostnamen mit der Namenskonvention <app-name>-<random-hash>.<region>.azurewebsites.net erstellen. Vorhandene App-Namen bleiben unverändert. Zum Beispiel:

myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Weitere 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. Es wird ein hochgradig skalierbarer Webhostingdienst mit eigenständigem Patching bereitgestellt. 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 enthält.

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-Apps (STS) mit Windows App Service unter Verwendung von MSBuild oder SCM_DO_BUILD wird noch nicht unterstützt. Die Unterstützung für diese Buildszenarien wurde nach dem ursprünglichen Datum der allgemeinen Verfügbarkeit zum 4. Dezember 2024 geplant. Außerhalb von App Service über Visual Studio, Visual Studio Code, GitHub Actions und Azure DevOps erstellte Bereitstellungen 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.

Erstellen einer ASP.NET-Web-App

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 finden Sie unter Installieren der Azure Developer CLI und Erstellen und Bereitstellen von Anwendungen mit der Azure Developer CLI.

Führen Sie die folgenden Schritte aus, um die ASP.NET Core-Web App-Vorlage abzurufen und zu initialisieren:

  1. Öffnen Sie auf Ihrem Computer in einem leeren Arbeitsverzeichnis ein Terminalfenster. Führen Sie den folgenden Befehl aus:

    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.

Veröffentlichen Ihrer 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. Wählen Sie Weiter aus.

    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. Nur die Zeichen 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 Abschluss des Prozesses werden die Azure-Ressourcen für Sie erstellt. 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. Wählen Sie in Visual Studio Code Ansicht>Befehlspalette aus, um die Befehlspalette zu öffnen.

  4. Suchen Sie nach Azure App Service: Neue Web-App erstellen (Erweitert), und wählen Sie die Option 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 unter Global eindeutigen Namen für die neue Web-App eingeben einen Namen, der in Azure eindeutig ist. Gültige Zeichen sind a-z, 0-9 und -. 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 Dialogfeld 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-Befehlszeilenschnittstelle gemäß der Beschreibung im Abschnitt Voraussetzungen installiert haben.
  2. Verwenden Sie az webapp up, um den Code in Ihrem lokalen Verzeichnis MyFirstAzureWebApp bereitzustellen:

    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 sind 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. Um eine Liste der zulässigen Regionen für Ihr Azure-Konto abzurufen, führen Sie den Befehl az account list-locations aus.

    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
    
  2. 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 sind a-z, 0-9 und -. Ein gutes Muster ist eine Kombination aus Ihrem Firmennamen und einem App-Bezeichner.
    • Optional können Sie den Parameter -Location <location-name> einfügen, wobei <location-name> eine verfügbare Azure-Region ist. Um eine Liste der zulässigen Regionen für Ihr Azure-Konto abzurufen, führen Sie den Befehl Get-AzLocation aus.

    Die Ausführung des Befehls kann einige Minuten dauern. Mit dem Befehl werden eine Ressourcengruppe, ein App Service-Plan und die App Service-Ressource erstellt.

  3. Führen Sie im Stammordner der Anwendung den Befehl dotnet publish aus, um Ihre lokale Anwendung MyFirstAzureWebApp für die Bereitstellung vorzubereiten:

    dotnet publish --configuration Release
    
  4. 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
    
  5. 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.

  6. Ö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 erledigen, nachdem Sie die App auf der Seite im Deployment Center 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 Projekt dotnetcore-docs-hello-world aus.
    • Wählen Sie in Branch die Option Mainbranch aus.

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

  7. Wählen Sie am unteren Rand der Seite die Option Bewerten + erstellen aus.

  8. Wählen Sie nach der Überprüfung unten auf der Seite 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 noch 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 Meldungen zum 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.

Aktualisieren der App und erneutes Bereitstellen

Nehmen Sie eine Änderung an Index.cshtml vor, und wiederholen Sie die Bereitstellung, 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. Doppelklicken Sie im Projektmappen-Explorer unter Ihrem Projekt auf Seiten>Index.cshtml, um die Datei zu öffnen.

  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 folgende Schritte 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

    Testen Sie diesen Ansatz mit GitHub Copilot:

    1. Wählen Sie das gesamte <div>-Element und dann aus.
    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 Befehlspalette mit STRG+UMSCHALT+P.

  4. Suchen Sie Azure App Service: In Web-App bereitstellen, und wählen Sie die Option 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 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.

  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 -Force
    
  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 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.

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

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

    Screenshot, der zeigt, wie Sie einen Codespace im GitHub-Repository „dotnetcore-docs-hello-world“ erstellen.

  3. Öffnen Sie Index.cshtml.

    Die Datei „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

    Testen Sie diesen Ansatz mit GitHub Copilot:

    1. Wählen Sie das gesamte <div>-Element und dann aus.
    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.

    Screenshot von Visual Studio Code im Browser, Panel „Quellcodeverwaltung“ mit der Commitnachricht „We love Azure“ und der hervorgehobenen Schaltfläche „Commit und Push“.

  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.

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 Befehl az webapp up, 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 einige Minuten 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 Dokumentation zur Azure Developer CLI.

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: