Schnellstart: Erstellen von ASP.NET Core-Web-Apps in AzureQuickstart: Create an ASP.NET Core web app in Azure

In dieser Schnellstartanleitung wird beschrieben, wie Sie Ihre erste ASP.NET Core-Web-App erstellen und für Azure App Service bereitstellen.In this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to Azure App Service. Von App Service werden .NET. 5.0-Apps unterstützt.App Service supports .NET 5.0 apps.

Am Ende verfügen Sie über eine Azure-Ressourcengruppe, die einen App Service-Hostingplan und eine App Service-Instanz mit einer bereitgestellten Webanwendung umfasst.When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.

VoraussetzungenPrerequisites

  • Ein Azure-Konto mit einem aktiven Abonnement.An Azure account with an active subscription. Sie können kostenlos ein Konto erstellen.Create an account for free.

  • Installieren Sie Visual Studio 2019 mit der Workload ASP.NET und Webentwicklung.Install Visual Studio 2019 with the ASP.NET and web development workload.

    Sie haben Visual Studio 2019 bereits installiert:If you've installed Visual Studio 2019 already:

    • Installieren Sie in Visual Studio die neuesten Updates, indem Sie Hilfe > Nach Updates suchen auswählen.Install the latest updates in Visual Studio by selecting Help > Check for Updates. Die neuesten Updates enthalten das .NET 5.0 SDK.The latest updates contain the .NET 5.0 SDK.
    • Fügen Sie die Workload hinzu. Wählen Sie dazu Tools > Tools und Features abrufen aus.Add the workload by selecting Tools > Get Tools and Features.

Erstellen einer ASP.NET Core-Web-AppCreate an ASP.NET Core web app

Führen Sie zum Erstellen einer ASP.NET Core-Web-App in Visual Studio die folgenden Schritte aus:Create an ASP.NET Core web app in Visual Studio by following these steps:

  1. Öffnen Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.Open Visual Studio and select Create a new project.

  2. Wählen Sie unter Neues Projekt erstellen die Option ASP.NET Core-Webanwendung aus, und vergewissern Sie sich, dass C# als Sprache für diese Option aufgeführt ist. Wählen Sie anschließend Weiter aus.In Create a new project, select ASP.NET Core Web Application and confirm that C# is listed in the languages for that choice, then select Next.

  3. Geben Sie Ihrem Webanwendungsprojekt unter Neues Projekt konfigurieren den Namen myFirstAzureWebApp, und wählen Sie Erstellen aus.In Configure your new project, name your web application project myFirstAzureWebApp, and select Create.

    Konfigurieren Ihres Web-App-Projekts

  4. Sie können einen beliebigen Typ von ASP.NET Core-Web-App für Azure bereitstellen, aber für diese Schnellstartanleitung sollten Sie die Vorlage Webanwendung auswählen.You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the Web Application template. Stellen Sie sicher, dass unter Authentifizierung die Option Keine Authentifizierung ausgewählt und keine andere Option festgelegt ist.Make sure Authentication is set to No Authentication, and that no other option is selected. Wählen Sie anschließend Erstellen.Then, select Create.

    Erstellen einer neuen ASP.NET Core-Web-App

  5. Wählen Sie im Visual Studio-Menü Debuggen > Starten ohne Debugging aus, um Ihre Web-App lokal auszuführen.From the Visual Studio menu, select Debug > Start Without Debugging to run your web app locally.

    Lokal ausgeführte Web-App

Veröffentlichen Ihrer Web-AppPublish your web app

Zum Veröffentlichen Ihrer Web-App müssen Sie zuerst eine neue App Service-Instanz erstellen und konfigurieren, auf der Sie Ihre App veröffentlichen können.To publish your web app, you must first create and configure a new App Service that you can publish your app to.

Erstellen Sie bei der Einrichtung der App Service-Instanz Folgendes:As part of setting up the App Service, you'll create:

  • Eine neue Ressourcengruppe, die alle Azure-Ressourcen für den Dienst enthalten soll.A new resource group to contain all of the Azure resources for the service.
  • Einen neuen Hostingplan, mit dem der Standort, die Größe und die Funktionen der Webserverfarm zum Hosten Ihrer App angegeben werden.A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

Führen Sie die folgenden Schritte aus, um Ihre App Service-Instanz zu erstellen und Ihre Web-App zu veröffentlichen:Follow these steps to create your App Service and publish your web app:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt myFirstAzureWebApp, und wählen Sie Veröffentlichen aus.In Solution Explorer, right-click the myFirstAzureWebApp project and select Publish.

  2. Wählen Sie unter Veröffentlichen die Option Azure aus, und klicken Sie auf Weiter.In Publish, select Azure and click Next.

  3. 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.Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Wählen Sie entweder Konto hinzufügen oder Anmelden aus, um sich bei Ihrem Azure-Abonnement anzumelden.Select either Add an account or Sign in to sign in to your Azure subscription. Wenn Sie bereits angemeldet sind, wählen Sie das gewünschte Konto aus.If you're already signed in, select the account you want.

    Anmelden bei Azure

  4. Klicken Sie rechts von App Service-Instanzen auf + .To the right of App Service instances, click +.

    Neue App Service-App

  5. Akzeptieren Sie unter Abonnement das angegebene Abonnement, oder wählen Sie in der Dropdownliste ein neues Abonnement aus.For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  6. Wählen Sie unter Ressourcengruppe die Option Neu aus.For Resource group, select New. Geben Sie unter Name der neuen Ressourcengruppe den Namen myResourceGroup ein, und wählen Sie OK aus.In New resource group name, enter myResourceGroup and select OK.

  7. Wählen Sie unter Hostingplan die Option Neu aus.For Hosting Plan, select New.

  8. Geben Sie im Dialogfeld Hostingplan: Neu erstellen die Werte ein, die in der folgenden Tabelle angegeben sind:In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    EinstellungSetting Empfohlener WertSuggested Value BESCHREIBUNGDescription
    HostingplanHosting Plan myFirstAzureWebAppPlanmyFirstAzureWebAppPlan Name des App Service-Plans.Name of the App Service plan.
    LocationLocation Europa, WestenWest Europe Das Rechenzentrum, in dem die Web-App gehostet wird.The datacenter where the web app is hosted.
    GrößeSize FreeFree Der Tarif bestimmt die Hostingfeatures.Pricing tier determines hosting features.

    Erstellen eines neuen Hostingplans

  9. 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 -.In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. Sie können den automatisch generierten eindeutigen Namen übernehmen.You can accept the automatically generated unique name. Die URL der Web-App lautet http://<app-name>.azurewebsites.net, wobei <app-name> der Name Ihrer App ist.The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  10. Wählen Sie Erstellen aus, um die Azure-Ressourcen zu erstellen.Select Create to create the Azure resources.

    Erstellen der App-Ressourcen

    Nach dem Abschluss des Assistenten werden die Azure-Ressourcen für Sie erstellt, und Sie können sie veröffentlichen.Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  11. Wählen Sie Fertig stellen aus, um den Assistenten zu schließen.Select Finish to close the wizard.

  12. Klicken Sie auf der Seite Veröffentlichen auf Veröffentlichen.In the Publish page, click Publish. Visual Studio erstellt, packt und veröffentlicht die App in Azure und startet sie anschließend im Standardbrowser.Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    In Azure ausgeführte veröffentlichte ASP.NET-Web-App

Glückwunsch!Congratulations! Ihre ASP.NET Core-Web-App wird live in Azure App Service ausgeführt.Your ASP.NET Core web app is running live in Azure App Service.

Aktualisieren der App und erneutes BereitstellenUpdate the app and redeploy

Führen Sie die folgenden Schritte aus, um Ihre Web-App zu aktualisieren und erneut bereitzustellen:Follow these steps to update and redeploy your web app:

  1. Öffnen Sie im Projektmappen-Explorer unter Ihrem Projekt Seiten > Index.cshtml.In Solution Explorer, under your project, open Pages > Index.cshtml.

  2. Ersetzen Sie das gesamte <div>-Tag durch den folgenden Code:Replace the entire <div> tag with the following code:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  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.To redeploy to Azure, right-click the myFirstAzureWebApp project in Solution Explorer and select Publish.

  4. Wählen Sie auf der Zusammenfassungsseite Veröffentlichen die Option Veröffentlichen aus.In the Publish summary page, select Publish.

    Nach Abschluss der Veröffentlichung wird in Visual Studio ein Browser mit der URL der Web-App gestartet.When publishing completes, Visual Studio launches a browser to the URL of the web app.

    In Azure ausgeführte aktualisierte ASP.NET-Web-App

Verwalten der Azure-AppManage the 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.To manage your web app, go to the Azure portal, and search for and select App Services.

Auswählen von „App Services“

Wählen Sie auf der Seite App Services den Namen Ihrer Web-App aus.On the App Services page, select the name of your web app.

Screenshot: 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.The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. Im linken Menü können Sie auf weitere Seiten für die Konfiguration Ihrer App zugreifen.The left menu provides further pages for configuring your app.

App Service im Azure-Portal

Bereinigen von RessourcenClean up resources

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt.In the preceding steps, you created Azure resources in a resource group. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Wählen Sie im Azure-Portalmenü oder auf der Startseite die Option Ressourcengruppen aus.From the Azure portal menu or Home page, select Resource groups. Wählen Sie auf der Seite Ressourcengruppen die Option myResourceGroup aus.Then, on the Resource groups page, select myResourceGroup.

Stellen Sie auf der Seite myResourceGroup sicher, dass die Ressourcen aufgelistet sind, die Sie löschen möchten.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Wählen Sie die Option Löschen aus, geben Sie zur Bestätigung im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Nächste SchritteNext steps

In dieser Schnellstartanleitung haben Sie Visual Studio verwendet, um eine ASP.NET Core-Web-App zu erstellen und für Azure App Service bereitzustellen.In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.

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:Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

App Service unter Linux bietet einen hochgradig skalierbaren Webhostingdienst mit Self-Patching unter Linux-Betriebssystemen.App Service on Linux provides a highly scalable, self-patching web hosting service using the Linux operating system. In diesem Schnellstartartikel wird erläutert, wie Sie eine .NET Core-App in App Service unter Linux erstellen.This quickstart shows how to create a .NET Core app on App Service on Linux. Sie erstellen die App mithilfe der Azure CLI und stellen mit Git den .NET Core-Code für die App bereit.You create the app using the Azure CLI, and you use Git to deploy the .NET Core code to the app.

In Azure ausgeführte Beispiel-App

Die Schritte in diesem Artikel können unter Mac, Windows oder Linux ausgeführt werden.You can follow the steps in this article using a Mac, Windows, or Linux machine.

Wenn Sie kein Azure-Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

Einrichten der anfänglichen UmgebungSet up your initial environment

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Lokales Erstellen der AppCreate the app locally

Erstellen Sie in einem Terminalfenster auf Ihrem Computer ein Verzeichnis mit dem Namen hellodotnetcore, und wechseln Sie dorthin.In a terminal window on your machine, create a directory named hellodotnetcore and change the current directory to it.

mkdir hellodotnetcore
cd hellodotnetcore

Erstellen Sie eine neue .NET Core-App.Create a new .NET Core app.

dotnet new web

Lokales Ausführen der AppRun the app locally

Führen Sie die Anwendung lokal aus, damit Sie sehen, wie sie beim Bereitstellen in Azure aussehen sollte.Run the application locally so that you see how it should look when you deploy it to Azure.

dotnet run

Öffnen Sie einen Webbrowser, und navigieren Sie zu der App auf http://localhost:5000.Open a web browser, and navigate to the app at http://localhost:5000.

Auf der Seite wird die Nachricht Hello World aus der Beispiel-App angezeigt.You see the Hello World message from the sample app displayed in the page.

Testen mit dem Browser

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Anmelden bei AzureSign into Azure

Melden Sie sich in Ihrem Terminalfenster mithilfe des folgenden Befehls bei Azure an:In your terminal window, log into Azure with the following command:

az login

Bereitstellen der AppDeploy the app

Stellen Sie den Code mithilfe des Befehls az webapp up in Ihrem lokalen Ordner (hellodotnetcore) bereit:Deploy the code in your local folder (hellodotnetcore) using the az webapp up command:

az webapp up --sku F1 --name <app-name> --os-type linux
  • Wird der Befehl az nicht erkannt, sollten Sie sich vergewissern, dass die Azure CLI wie unter Einrichten der anfänglichen Umgebung beschrieben installiert wurde.If the az command isn't recognized, be sure you have the Azure CLI installed as described in Set up your initial environment.
  • Ersetzen Sie <app-name> durch einen Namen, der innerhalb von Azure eindeutig ist (gültige Zeichen: a-z, 0-9 und - ).Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Ein bewährtes Muster ist eine Kombination aus Ihrem Firmennamen und einer App-ID.A good pattern is to use a combination of your company name and an app identifier.
  • Mit dem Argument --sku F1 wird die Web-App im Tarif „Free“ erstellt.The --sku F1 argument creates the web app on the Free pricing tier. Lassen Sie dieses Argument weg, um einen schnelleren Premium-Tarif zu verwenden. Dieser verursacht jedoch stündlich Kosten.Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • Optional können Sie das Argument --location <location-name> einfügen, wobei <location-name> eine verfügbare Azure-Region ist.You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. 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.You can retrieve a list of allowable regions for your Azure account by running the az account list-locations command.

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.The command may take a few minutes to complete. Bei der Ausführung werden Nachrichten zur Erstellung der Ressourcengruppe, des App Service-Plans und der Hosting-App, zur Konfiguration der Protokollierung und zur anschließenden ZIP-Bereitstellung bereitgestellt.While running, it provides messages about creating the resource group, the App Service plan and hosting app, configuring logging, then performing ZIP deployment. Anschließend wird die Meldung „You can launch the app at http://<app-name>.azurewebsites.net“ (Sie können die App unter http://.azurewebsites.net starten.) angezeigt. Dabei handelt es sich um die URL der App in Azure.It then gives the message, "You can launch the app at http://<app-name>.azurewebsites.net", which is the app's URL on Azure.

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Hinweis

Der Befehl az webapp up bewirkt Folgendes:The az webapp up command does the following actions:

Navigieren zur AppBrowse to the app

Navigieren Sie in Ihrem Webbrowser zu der bereitgestellten Anwendung.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

Der .NET Core-Beispielcode wird in App Service unter Linux mit einem integrierten Image ausgeführt.The .NET Core sample code is running in App Service on Linux with a built-in image.

In Azure ausgeführte Beispiel-App

Glückwunsch!Congratulations! Sie haben Ihre erste .NET Core-App für App Service unter Linux bereitgestellt.You've deployed your first .NET Core app to App Service on Linux.

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Aktualisieren und erneutes Bereitstellen des CodesUpdate and redeploy the code

Öffnen Sie im lokalen Verzeichnis die Datei Startup.cs.In the local directory, open the Startup.cs file. Nehmen Sie eine kleine Änderung am Text im Methodenaufruf context.Response.WriteAsync vor:Make a small change to the text in the method call context.Response.WriteAsync:

await context.Response.WriteAsync("Hello Azure!");

Speichern Sie Ihre Änderungen, und stellen Sie die App dann mit dem Befehl az webapp up erneut bereit:Save your changes, then redeploy the app using the az webapp up command again:

az webapp up

In diesem Befehl werden lokal zwischengespeicherte Werte aus der Datei .azure/config verwendet (einschließlich App-Name, Ressourcengruppe und App Service-Plan).This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and 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.Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

In Azure ausgeführte aktualisierte Beispiel-App

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Verwalten Ihrer neuen Azure-AppManage your new Azure app

Wechseln Sie zum Azure-Portal, um die erstellte App zu verwalten.Go to the Azure portal to manage the app you created.

Klicken Sie im linken Menü auf App Services und anschließend auf den Namen Ihrer Azure-App.From the left menu, click App Services, and then click the name of your Azure app.

Screenshot: Seite „App Services“ mit einer ausgewählten Beispiel-Azure-App

Die Übersichtsseite Ihrer App wird angezeigt.You see your app's Overview page. Hier können Sie einfache Verwaltungsaufgaben wie Durchsuchen, Beenden, Neustarten und Löschen durchführen.Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

App Service-Seite im Azure-Portal

Im linken Menü werden verschiedene Seiten für die Konfiguration Ihrer App angezeigt.The left menu provides different pages for configuring your app.

Bereinigen von RessourcenClean up resources

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt.In the preceding steps, you created Azure resources in a resource group. 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:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.This command may take a minute to run.

Treten Probleme auf? Informieren Sie uns darüber.Having issues? Let us know.

Nächste SchritteNext steps