Bereitstellen von ASP.NET Core-Apps in Azure App Service

Azure App Service ist ein Microsoft Cloud Computing-Plattformdienst zum Hosten von Web-Apps. Dazu gehört auch ASP.NET Core.

Zuverlässige Web-App-Muster

Einen Leitfaden zum Erstellen einer modernen, zuverlässigen, leistungsfähigen, testbaren, kosteneffizienten und skalierbaren ASP.NET Core-App finden Sie in den YouTube-Videos und im Artikel zum zuverlässigen Web-App-Muster für .NET – ganz gleich, ob Sie eine App von Grund auf neu erstellen oder umgestalten möchten.

Nützliche Ressourcen

In der App Service-Dokumentation finden Sie die Azure-Apps-Dokumentation, Tutorials, Beispiele und Leitfäden sowie andere Ressourcen. Dies sind zwei erwähnenswerte Tutorials, die auf das Hosten von ASP.NET Core-Apps eingehen:

Erstellen einer ASP.NET Core-Web-App in Azure
Verwenden Sie Visual Studio, um ASP.NET Core-Web-Apps zu erstellen und in Azure App Service unter Windows bereitzustellen.

Erstellen einer .NET Core-App in App Service für Linux
Verwenden Sie die Befehlszeile, um ASP.NET Core-Web-Apps zu erstellen und in Azure App Service unter Linux bereitzustellen.

Die ASP.NET Core-Version, die unter Azure App Service verfügbar ist, finden Sie unter ASP.NET Core im App Service-Dashboard.

Abonnieren Sie das Repository für App Service-Ankündigungen, und überwachen Sie die Issues. Das App Service-Team postet regelmäßig Ankündigungen und neue Szenarien in App Service.

Die folgenden Artikel sind in der ASP.NET Core-Dokumentation verfügbar:

Veröffentlichen einer ASP.NET Core-App in Azure mit Visual Studio
Erfahren Sie, wie eine ASP.NET Core-App in Azure App Service mit Visual Studio veröffentlicht wird.

Erstellen Ihrer ersten Pipeline
Richten Sie ein CI-Build für eine ASP.NET Core-App ein, und erstellen Sie dann ein Continuous Deployment-Release für Azure App Service.

Azure Web App-Sandbox
Entdecken Sie die Einschränkungen der Azure App Service-Laufzeitausführung, die durch die Azure Apps-Plattform erzwungen werden.

Problembehandlung und Debuggen von ASP.NET Core-Projekten
In diesem Artikel werden Warnungen und Fehler erläutert. Außerdem erfahren Sie, wie die Problembehandlung in ASP.NET Core-Projekten funktioniert.

Anwendungskonfiguration

Plattform

Die Plattformarchitektur (x86/x64) einer App Services-App wird in den Einstellungen der App im Azure-Portal festgelegt. Dies gilt für Apps, die in einem A-Series-Computetarif (Basic) oder einem höheren Hostingtarif gehostet werden. Überprüfen Sie, ob die Veröffentlichungseinstellungen der App (z. B im Veröffentlichungsprofil (PUBXML) von Visual Studio) mit der Einstellung in der Dienstkonfiguration der App im Azure-Portal übereinstimmen.

Weitere Informationen zu .NET Core-Frameworkkomponenten und Verteilungsmethoden (z. B. .NET Core-Runtime und .NET Core SDK) finden Sie unter Weitere Informationen zu .NET Core: Komposition.

Packages

Beziehen Sie die folgenden NuGet-Pakete ein, die automatische Protokollierungsfeatures für Apps bieten, die für Azure App Service bereitgestellt werden:

• Microsoft.AspNetCore.AzureAppServices.HostingStartup verwendet IHostingStartup, um die ASP.NET Core-Protokollierungsintegration mit Azure App Service bereitzustellen. Die hinzugefügten Protokollierungsfeatures werden vom Microsoft.AspNetCore.AzureAppServicesIntegration-Paket bereitgestellt.
• Microsoft.AspNetCore.AzureAppServicesIntegration führt AddAzureWebAppDiagnostics aus, um Anbieter für die Azure App Service-Diagnoseprotokollierung zum Paket Microsoft.Extensions.Logging.AzureAppServices hinzuzufügen.
• Microsoft.Extensions.Logging.AzureAppServices stellt Protokollierungsimplementierungen bereit, um die Azure App Service-Features für Diagnoseprotokolle und Protokollstreaming zu unterstützen.

Auf die vorherigen Pakete muss in der Projektdatei der App explizit verwiesen werden.

Überschreiben der App-Konfiguration im Azure-Portal

Proxyserver und Lastenausgleichsszenarien

Die Middleware für die Integration von IIS, die beim Out-of-Process-Hosting die Middleware für weitergeleitete Header konfiguriert, und das ASP.NET Core-Modul sind so konfiguriert, dass sie das Schema (HTTP/HTTPS) und die Remote-IP-Adresse an die Stelle weiterleiten, von der die Anforderung stammte. Möglicherweise ist zusätzliche Konfiguration für Apps erforderlich, die hinter weiteren Proxyservern und Lastenausgleichsmodulen (Load Balancer) gehostet werden. Weitere Informationen hierzu feinden Sie unter Konfigurieren von ASP.NET Core zur Verwendung mit Proxyservern und Lastenausgleich.

Überwachung und Protokollierung

In den folgenden Artikeln finden Sie Informationen zum Überwachen, Protokollieren und zur Problembehandlung:

Überwachen von Apps in Azure App Service
Erfahren Sie, wie Sie Kontingente und Metrik für Apps und App Service-Pläne prüfen.

Aktivieren der Diagnoseprotokollierung für Apps in Azure App Service
Erfahren Sie, wie Sie die Diagnosesprotokollierung für HTTP-Statuscodes, fehlgeschlagene Anforderungen und Webserveraktivitäten aktivieren und auf die Protokolle zugreifen.

Fehlerbehandlung in ASP.NET Core
Lernen Sie gängige Methoden zur Fehlerbehandlung in ASP.NET Core-Apps kennen.

Problembehandlung bei ASP.NET Core in Azure App Service und IIS
Erfahren Sie, wie Sie Probleme mit Azure App Service-Bereitstellungen mit ASP.NET Core-Apps diagnostizieren können.

Problembehandlung für häufige Fehler bei Azure App Service und IIS mit ASP.NET Core
Sehen Sie sich häufig auftretende Fehler und entsprechende Hinweise zur Fehlerbehebung bei der Bereitstellungskonfiguration für von Azure App Service/IIS gehosteten Apps an.

Data Protection-Schlüsselbund und -Bereitstellungsslots

Datenschutzschlüssel werden im Ordner %HOME%\ASP.NET\DataProtection-Keys persistiert. Dieser Ordner wird von einem Netzwerkspeicher unterstützt und mit allen Computern, auf denen die App gehostet wird, synchronisiert. Ruhende Schlüssel werden nicht geschützt. Dieser Ordner stellt den Schlüsselbund für alle Instanzen einer App in einem einzelnen Bereitstellungsslot bereit. Separate Bereitstellungsslots, wie Staging und Produktion, verwenden keinen gemeinsamen Schlüsselbund.

Wenn Sie zwischen Bereitstellungsslots wechseln, können Systeme, die Data Protection verwenden, gespeicherte Daten nicht mit dem Schlüsselbund des vorherigen Slots entschlüsseln. ASP.NET Cookie-Middleware verwendet Data Protection zum Schutz ihrer Cookies. Dadurch werden Benutzer aus einer App abgemeldet, die gewöhnliche ASP.NET-Cookiemiddleware verwendet. Verwende Sie einen externen Schlüsselbundanbieter für eine slotunabhängige Schlüsselbundlösung wie z.B.:

• Azure Blob Storage
• Azure Key Vault
• SQL-Speicher
• Redis Cache

Weitere Informationen finden Sie unter Schlüsselspeicheranbieter in ASP.NET Core.

Bereitstellen einer ASP.NET Core-App, die eine Vorschauversion von .NET Core verwendet

In den folgenden Ressourcen finden Sie Informationen zum Bereitstellen einer App, die eine Vorschauversion von .NET Core verwendet. Diese Verfahren werden auch verwendet, wenn die Runtime verfügbar ist, aber das SDK nicht in Azure App Service installiert wurde.

• Angeben der .NET Core SDK-Version mithilfe von Azure Pipelines
• Bereitstellen einer eigenständigen Vorschauversions-App
• Verwenden von Docker mit Web-Apps für Container
• Installieren der Websiteerweiterung (Vorschau)

Die ASP.NET Core-Version, die unter Azure App Service verfügbar ist, finden Sie unter ASP.NET Core im App Service-Dashboard.

Informationen zum Auswählen der Version des .NET SDK für eigenständige Bereitstellungen finden Sie unter Auswählen der zu verwendenden .NET Core-Version.

Angeben der .NET Core SDK-Version mithilfe von Azure Pipelines

Verwenden Sie die Szenarien zum Entwerfen einer CI/CD-Pipeline mithilfe von Azure DevOps, um einen Continuous Integration-Build mit Azure DevOps einzurichten. Nach dem Erstellen des Azure DevOps-Builds können Sie diesen optional für die Verwendung einer bestimmten SDK-Version konfigurieren.

Angeben der .NET Core SDK-Version

Wenn Sie das App Service-Bereitstellungscenter zum Erstellen eines Azure DevOps-Builds verwenden, enthält die Standardbuildpipeline die Schritte für Restore, Build, Test und Publish. Zum Angeben der SDK-Version klicken Sie auf die Schaltfläche Hinzufügen (+) in der Liste mit Agent-Aufträgen, um einen neuen Schritt hinzuzufügen. Suchen Sie in der Suchleiste nach .NET Core SDK.

Verschieben Sie den Schritt an die erste Stelle im Build, sodass die nachfolgenden Schritte die angegebene Version des .NET Core SDK verwenden. Geben Sie die Version des .NET Core SDK an. In diesem Beispiel ist das SDK auf 3.0.100 festgelegt.

Um eine eigenständige Bereitstellung (Self-Contained Deployment, SCD) zu veröffentlichen, konfigurieren Sie SCD im Schritt Publish, und geben Sie den Runtimebezeichner (Runtime Identifier, RID) an.

Bereitstellen einer eigenständigen Vorschauversions-App

Eine eigenständige Bereitstellung, die auf eine Vorschauruntime abzielt, enthält die Vorschauruntime in der Bereitstellung.

Wenn Sie eine eigenständige App bereitstellen, gilt Folgendes:

• Die Site in Azure App Service erfordert nicht die Vorschau-Websiteerweiterung.
• Die App muss gemäß einem anderen Ansatz veröffentlicht werden, als beim Veröffentlichen für eine frameworkabhängige Bereitstellung.

Befolgen Sie die Anweisungen im Abschnitt Bereitstellen einer eigenständigen Vorschau-App.

Verwenden von Docker mit Web-Apps für Container

Der Docker Hub unter https://hub.docker.com/_/microsoft-dotnet enthält die aktuellen Images für die Docker-Vorschauversion. Die Images können als Basisimage verwendet werden. Verwenden Sie das Image, und führen Sie wie gewohnt eine Bereitstellung für Web-Apps für Container durch.

Installieren der Websiteerweiterung (Vorschau)

Sollte ein Problem mit dem Verwenden der Vorschau der Websiteerweiterung auftreten, öffnen Sie ein dotnet/AspNetCore-Issue.

1. Navigieren Sie im Azure-Portal zu „App Service“.
2. Wählen Sie die Web-App aus.
3. Geben Sie „ex“ in das Suchfeld ein, um nach „Extensions“ (Erweiterungen) zu filtern, oder durchsuchen Sie die Liste der Verwaltungstools.
4. Wählen Sie Erweiterungen.
5. Klicken Sie auf Hinzufügen.
6. Wählen Sie die Erweiterung ASP.NET Core {X.Y} ({x64|x86}) Runtime aus der Liste aus. Dabei ist {X.Y} die ASP.NET Core-Vorschauversion, und {x64|x86} gibt die Plattform an.
7. Klicken Sie auf OK, um die rechtlichen Bedingungen zu akzeptieren.
8. Wählen Sie OK aus, um die Erweiterung zu installieren.

Nach Abschluss dieses Vorgangs wird die neueste .NET Core-Vorschauversion installiert. Überprüfen Sie die Installation:

1. Wählen Sie Erweiterte Tools aus.

2. Wählen Sie Go unter Erweiterte Tools aus.

3. Wählen Sie das Menüelement Debugkonsole>PowerShell aus.

4. Führen Sie in der PowerShell-Eingabeaufforderung den folgenden Befehl aus. Ersetzen Sie im Befehl die ASP.NET Core-Runtimeversion durch {X.Y} und die Plattform durch {PLATFORM}:

   Test-Path D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.{PLATFORM}\
   

   Der Befehl gibt True zurück, wenn die x64-Vorschauruntime installiert ist.

Test-Path D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x64\

Verwenden der Vorschau-Websiteerweiterung mit einer ARM-Vorlage

Wenn Sie eine ARM-Vorlage zum Erstellen und Bereitstellen von Anwendungen verwenden, können Sie den Ressourcentyp Microsoft.Web/sites/siteextensions verwenden, um die Websiteerweiterung zu einer Web-App hinzuzufügen. Im folgenden Beispiel wird der App die Websiteerweiterung (AspNetCoreRuntime.5.0.x64) der ASP.NET Core 5.0 (x64)-Runtime hinzugefügt:

{
    ...
    "parameters": {
        "site_name": {
            "defaultValue": "{SITE NAME}",
            "type": "String"
        },
        ...
    },       
    ...
    "resources": [
        ...
        {
            "type": "Microsoft.Web/sites/siteextensions",
            "apiVersion": "2018-11-01",
            "name": "[concat(parameters('site_name'), '/AspNetCoreRuntime.5.0.x64')]",
            "location": "[resourceGroup().location]",
            "dependsOn": [
                "[resourceId('Microsoft.Web/sites', parameters('site_name'))]"
            ]
        }
    ]
}
    

Verwenden Sie für den Platzhalter {SITE NAME} den Namen der App im Azure App Service (z. B. contoso).

Veröffentlichen und Bereitstellen der App

Frameworkabhängige Bereitstellung einer App

Apps, die als frameworkabhängig veröffentlicht werden, sind plattformübergreifend und enthalten die .NET-Runtime nicht in der Bereitstellung. Azure App Service enthält die .NET-Runtime.

Bereitstellen der App als eigenständige App

Durch die Veröffentlichung einer eigenständigen App wird eine plattformspezifische ausführbare Datei erzeugt. Der Ausgabeordner der Veröffentlichung enthält alle Komponenten der App, einschließlich .NET-Bibliotheken und Zielruntime. Weitere Informationen finden Sie unter [Veröffentlichen als eigenständig]/dotnet/core/deploying/#publish-self-contained). Nutzen Sie Visual Studio oder die .NET-CLI für eine eigenständige Bereitstellung (Self-Contained Deployment, SCD).

Protokolleinstellungen (HTTPS)

Durch sichere Protokollbindungen können Sie ein Zertifikat angeben, das verwendet werden soll, wenn über HTTPS auf Anforderungen geantwortet wird. Bindungen erfordern gültige private Zertifikate (.pfx), die für den angegebenen Hostnamen ausgestellt wurden. Weitere Informationen finden Sie unter Tutorial: Binden eines vorhandenen benutzerdefinierten SSL-Zertifikats an Azure App Service.

Transformieren von web.config

Wenn Sie web.config beim Veröffentlichen transformieren müssen (z.B. Umgebungsvariablen basierend auf der Konfiguration, dem Profil oder der Umgebung festlegen müssen), finden Sie weitere Informationen unter Transformieren von web.config.

Zusätzliche Ressourcen

• App Service: Übersicht
• Übersicht: Azure App Service-Diagnose
• Hosten von ASP.NET Core in einer Webfarm
• Tutorial: Verbindungsherstellung mit SQL-Datenbank über .NET App Service ohne Geheimnisse mithilfe einer verwalteten Identität

Azure App Service auf Windows Server verwendet Internetinformationsdienste (IIS). Kestrel und YARP am Front-End stellen den Lastenausgleich bereit. Die folgenden Artikel gehen auf die zugrunde liegende IIS-Technologie ein:

• Hosten von ASP.NET Core unter Windows mit IIS
• ASP.NET Core-Modul (ANCM) für IIS
• IIS-Module mit ASP.NET Core
• Windows Server – IT-Administrator-Inhalt für aktuelle und frühere Versionen