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

Azure App Service ist ein Microsoft Cloud Computing-Plattformdienst zum Hosten von Web-Apps. Dazu gehört auch ASP.NET Core.Azure App Service is a Microsoft cloud computing platform service for hosting web apps, including ASP.NET Core.

Nützliche RessourcenUseful resources

In der App Service-Dokumentation finden Sie die Azure-Apps-Dokumentation, Tutorials, Beispiele und Leitfäden sowie andere Ressourcen.App Service Documentation is the home for Azure Apps documentation, tutorials, samples, how-to guides, and other resources. Dies sind zwei erwähnenswerte Tutorials, die auf das Hosten von ASP.NET Core-Apps eingehen:Two notable tutorials that pertain to hosting ASP.NET Core apps are:

Erstellen einer ASP.NET Core-Web-App in AzureCreate an 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.Use Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service on Windows.

Erstellen einer .NET Core-App in App Service für LinuxCreate an ASP.NET Core app in App Service on Linux
Verwenden Sie die Befehlszeile, um ASP.NET Core-Web-Apps zu erstellen und in Azure App Service unter Linux bereitzustellen.Use the command line to create and deploy an ASP.NET Core web app to Azure App Service on Linux.

Die ASP.NET Core-Version, die unter Azure App Service verfügbar ist, finden Sie unter ASP.NET Core im App Service-Dashboard.See the ASP.NET Core on App Service Dashboard for the version of ASP.NET Core available on Azure App service.

Abonnieren Sie das Repository für App Service-Ankündigungen, und überwachen Sie die Issues.Subscribe to the App Service Announcements repository and monitor the issues. Das App Service-Team postet regelmäßig Ankündigungen und neue Szenarien in App Service.The App Service team regularly posts announcements and scenarios arriving in App Service.

Die folgenden Artikel sind in der ASP.NET Core-Dokumentation verfügbar:The following articles are available in ASP.NET Core documentation:

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.Learn how to publish an ASP.NET Core app to Azure App Service using Visual Studio.

Continuous Deployment in Azure mit Visual Studio und Git mit ASP.NET Core
Erfahren Sie, wie Sie mit Visual Studio eine ASP.NET Core-Web-App erstellen und sie unter Verwendung von Git für Continuous Deployment in Azure App Service bereitstellen.Learn how to create an ASP.NET Core web app using Visual Studio and deploy it to Azure App Service using Git for continuous deployment.

Erstellen Sie Ihre erste PipelineCreate your first 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.Set up a CI build for an ASP.NET Core app, then create a continuous deployment release to Azure App Service.

Azure Web App-SandboxAzure Web App sandbox
Entdecken Sie die Einschränkungen der Azure App Service-Laufzeitausführung, die durch die Azure Apps-Plattform erzwungen werden.Discover Azure App Service runtime execution limitations enforced by the Azure Apps platform.

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.Understand and troubleshoot warnings and errors with ASP.NET Core projects.

AnwendungskonfigurationApplication configuration

PlattformPlatform

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.The platform architecture (x86/x64) of an App Services app is set in the app's settings in the Azure Portal for apps that are hosted on an A-series compute (Basic) or higher hosting tier. Ü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.Confirm that the app's publish settings (for example, in the Visual Studio publish profile (.pubxml)) match the setting in the app's service configuration in the Azure Portal.

In Azure App Service sind Runtimes für 64-Bit- und 32-Bit-Apps (x64 und x86) vorhanden.Runtimes for 64-bit (x64) and 32-bit (x86) apps are present on Azure App Service. Das .NET Core SDK, das in Azure App Service zur Verfügung steht, ist eine 32-Bit-Version. Sie können jedoch auch lokal erstellte 64-Bit-Apps mit der Kudu-Konsole oder dem Veröffentlichungsprozess in Visual Studio bereitstellen.The .NET Core SDK available on App Service is 32-bit, but you can deploy 64-bit apps built locally using the Kudu console or the publish process in Visual Studio. Weitere Informationen finden Sie im Abschnitt Publish and deploy the app (Veröffentlichen und Bereitstellen der App).For more information, see the Publish and deploy the app section.

Für Apps mit nativen Abhängigkeiten stehen in Azure App Service Runtimes für 32-Bit- und 32-Bit-Apps (x86 und x86) zur Verfügung.For apps with native dependencies, runtimes for 32-bit (x86) apps are present on Azure App Service. Das .NET Core SDK in Azure App Service ist eine 32-Bit-Version.The .NET Core SDK available on App Service is 32-bit.

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: Aufbau.For more information on .NET Core framework components and distribution methods, such as information on the .NET Core runtime and the .NET Core SDK, see About .NET Core: Composition.

PaketePackages

Beziehen Sie die folgenden NuGet-Pakete ein, die automatische Protokollierungsfeatures für Apps bieten, die für Azure App Service bereitgestellt werden:Include the following NuGet packages to provide automatic logging features for apps deployed to Azure App Service:

Die Metapakete Microsoft.AspNetCore.App sind nicht in den vorherigen Paketen enthalten.The preceding packages aren't available from the Microsoft.AspNetCore.App metapackage. Apps, deren Ziel das .NET Framework ist oder die auf das Microsoft.AspNetCore.App-Metapaket verweisen, müssen explizit auf die einzelnen Pakete in der Projektdatei der App verweisen.Apps that target .NET Framework or reference the Microsoft.AspNetCore.App metapackage must explicitly reference the individual packages in the app's project file.

Überschreiben der App-Konfiguration im Azure-PortalOverride app configuration using the Azure Portal

Über die App-Einstellungen im Azure-Portal können Sie Umgebungsvariablen für die App festlegen.App settings in the Azure Portal permit you to set environment variables for the app. Umgebungsvariablen können von Umgebungsvariablen-Konfigurationsanbietern verarbeitet werden.Environment variables can be consumed by the Environment Variables Configuration Provider.

Wenn eine App-Einstellung im Azure-Portal erstellt oder geändert und die Schaltfläche Speichern ausgewählt wird, wird die Azure-App neu gestartet.When an app setting is created or modified in the Azure Portal and the Save button is selected, the Azure App is restarted. Die Umgebungsvariable steht der App nach dem Neustart des Diensts zur Verfügung.The environment variable is available to the app after the service restarts.

Wenn eine App einen generischen Host verwendet, werden beim Abruf von CreateDefaultBuilder zum Erstellen des Hosts Umgebungsvariablen in die Konfiguration der App geladen.When an app uses the Generic Host, environment variables are loaded into the app's configuration when CreateDefaultBuilder is called to build the host. Weitere Informationen finden Sie unter Generischer .NET-Host in ASP.NET Core und unter Umgebungsvariablen-Konfigurationsanbieter.For more information, see Generischer .NET-Host in ASP.NET Core and the Environment Variables Configuration Provider.

Über die App-Einstellungen im Azure-Portal können Sie Umgebungsvariablen für die App festlegen.App settings in the Azure Portal permit you to set environment variables for the app. Umgebungsvariablen können von Umgebungsvariablen-Konfigurationsanbietern verarbeitet werden.Environment variables can be consumed by the Environment Variables Configuration Provider.

Wenn eine App-Einstellung im Azure-Portal erstellt oder geändert und die Schaltfläche Speichern ausgewählt wird, wird die Azure-App neu gestartet.When an app setting is created or modified in the Azure Portal and the Save button is selected, the Azure App is restarted. Die Umgebungsvariable steht der App nach dem Neustart des Diensts zur Verfügung.The environment variable is available to the app after the service restarts.

Wenn eine App einen Webhost verwendet, werden beim Abruf von CreateDefaultBuilder zum Erstellen des Hosts Umgebungsvariablen in die Konfiguration der App geladen.When an app uses the Web Host, environment variables are loaded into the app's configuration when CreateDefaultBuilder is called to build the host. Weitere Informationen finden Sie unter ASP.NET Core-Webhost und unter Umgebungsvariablen-Konfigurationsanbieter.For more information, see ASP.NET Core-Webhost and the Environment Variables Configuration Provider.

Proxyserver und LastenausgleichsszenarienProxy server and load balancer scenarios

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.The IIS Integration Middleware, which configures Forwarded Headers Middleware when hosting out-of-process, and the ASP.NET Core Module are configured to forward the scheme (HTTP/HTTPS) and the remote IP address where the request originated. Möglicherweise ist zusätzliche Konfiguration für Apps erforderlich, die hinter weiteren Proxyservern und Lastenausgleichsmodulen (Load Balancer) gehostet werden.Additional configuration might be required for apps hosted behind additional proxy servers and load balancers. Weitere Informationen hierzu feinden Sie unter Konfigurieren von ASP.NET Core zur Verwendung mit Proxyservern und Lastenausgleich.For more information, see Configure ASP.NET Core to work with proxy servers and load balancers.

Überwachung und ProtokollierungMonitoring and logging

In App Service bereitgestellte ASP.NET Core-Apps erhalten automatisch die App Service-Erweiterung ASP.NET Core Logging Integration (ASP.NET Core-Protokollierungsintegration).ASP.NET Core apps deployed to App Service automatically receive an App Service extension, ASP.NET Core Logging Integration. Durch diese Erweiterung ist die Protokollierungsintegration für ASP.NET Core-Apps in Azure App Service möglich.The extension enables logging integration for ASP.NET Core apps on Azure App Service.

In App Service bereitgestellte ASP.NET Core-Apps erhalten automatisch die App Service-Erweiterung ASP.NET Core-Protokollierungserweiterungen.ASP.NET Core apps deployed to App Service automatically receive an App Service extension, ASP.NET Core Logging Extensions. Durch diese Erweiterung ist die Protokollierungsintegration für ASP.NET Core-Apps in Azure App Service möglich.The extension enables logging integration for ASP.NET Core apps on Azure App Service.

In den folgenden Artikeln finden Sie Informationen zum Überwachen, Protokollieren und zur Problembehandlung:For monitoring, logging, and troubleshooting information, see the following articles:

Überwachen von Apps in Azure App ServiceMonitor apps in Azure App Service
Erfahren Sie, wie Sie Kontingente und Metrik für Apps und App Service-Pläne prüfen.Learn how to review quotas and metrics for apps and App Service plans.

Aktivieren der Diagnoseprotokollierung für Apps in Azure App ServiceEnable diagnostics logging for 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.Discover how to enable and access diagnostic logging for HTTP status codes, failed requests, and web server activity.

Fehlerbehandlung in ASP.NET Core
Lernen Sie gängige Methoden zur Fehlerbehandlung in ASP.NET Core-Apps kennen.Understand common approaches to handling errors in ASP.NET Core apps.

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.Learn how to diagnose issues with Azure App Service deployments with ASP.NET Core apps.

Referenz zu häufigen Fehlern 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.See the common deployment configuration errors for apps hosted by Azure App Service/IIS with troubleshooting advice.

Data Protection-Schlüsselbund und -BereitstellungsslotsData Protection key ring and deployment slots

Data Protection-Schlüssel werden im Ordner %HOME%\ASP.NET\DataProtection-Keys gespeichert.Data Protection keys are persisted to the %HOME%\ASP.NET\DataProtection-Keys folder. Dieser Ordner wird von einem Netzwerkspeicher unterstützt und mit allen Computern, auf denen die App gehostet wird, synchronisiert.This folder is backed by network storage and is synchronized across all machines hosting the app. Ruhende Schlüssel werden nicht geschützt.Keys aren't protected at rest. Dieser Ordner stellt den Schlüsselbund für alle Instanzen einer App in einem einzelnen Bereitstellungsslot bereit.This folder supplies the key ring to all instances of an app in a single deployment slot. Separate Bereitstellungsslots, wie Staging und Produktion, verwenden keinen gemeinsamen Schlüsselbund.Separate deployment slots, such as Staging and Production, don't share a key ring.

Wenn Sie zwischen Bereitstellungsslots wechseln, können Systeme, die Data Protection verwenden, gespeicherte Daten nicht mit dem Schlüsselbund des vorherigen Slots entschlüsseln.When swapping between deployment slots, any system using data protection won't be able to decrypt stored data using the key ring inside the previous slot. ASP.NET-Cookiemiddleware verwendet Data Protection zum Schutz ihrer cookies.ASP.NET Cookie Middleware uses data protection to protect its cookies. Dadurch werden Benutzer aus einer App abgemeldet, die gewöhnliche ASP.NET-Cookiemiddleware verwendet.This leads to users being signed out of an app that uses the standard ASP.NET Cookie Middleware. Verwende Sie einen externen Schlüsselbundanbieter für eine slotunabhängige Schlüsselbundlösung wie z.B.:For a slot-independent key ring solution, use an external key ring provider, such as:

  • Azure Blob StorageAzure Blob Storage
  • Azure Key VaultAzure Key Vault
  • SQL-SpeicherSQL store
  • Redis CacheRedis cache

Weitere Informationen finden Sie unter Schlüsselspeicher Anbieter in ASP.net Core.For more information, see Schlüsselspeicher Anbieter in ASP.net Core.

Bereitstellen einer ASP.NET Core-App, die eine Vorschauversion von .NET Core verwendetDeploy an ASP.NET Core app that uses a .NET Core preview

In den folgenden Ressourcen finden Sie Informationen zum Bereitstellen einer App, die eine Vorschauversion von .NET Core verwendet.To deploy an app that uses a preview release of .NET Core, see the following resources. Diese Verfahren werden auch verwendet, wenn die Runtime verfügbar ist, aber das SDK nicht in Azure App Service installiert wurde.These approaches are also used when the runtime is available but the SDK hasn't been installed on Azure App Service.

Die ASP.NET Core-Version, die unter Azure App Service verfügbar ist, finden Sie unter ASP.NET Core im App Service-Dashboard.See the ASP.NET Core on App Service Dashboard for the version of ASP.NET Core available on Azure App service.

Angeben der .NET Core SDK-Version mithilfe von Azure PipelinesSpecify the .NET Core SDK Version using 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.Use Azure App Service CI/CD scenarios to set up a continuous integration build with Azure DevOps. Nach dem Erstellen des Azure DevOps-Builds können Sie diesen optional für die Verwendung einer bestimmten SDK-Version konfigurieren.After the Azure DevOps build is created, optionally configure the build to use a specific SDK version.

Angeben der .NET Core SDK-VersionSpecify the .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.When using the App Service deployment center to create an Azure DevOps build, the default build pipeline includes steps for Restore, Build, Test, and 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.To specify the SDK version, select the Add (+) button in the Agent job list to add a new step. Suchen Sie in der Suchleiste nach .NET Core SDK.Search for .NET Core SDK in the search bar.

Hinzufügen des .NET Core SDK-Schritts

Verschieben Sie den Schritt an die erste Stelle im Build, sodass die nachfolgenden Schritte die angegebene Version des .NET Core SDK verwenden.Move the step into the first position in the build so that the steps following it use the specified version of the .NET Core SDK. Geben Sie die Version des .NET Core SDK an.Specify the version of the .NET Core SDK. In diesem Beispiel ist das SDK auf 3.0.100 festgelegt.In this example, the SDK is set to 3.0.100.

Abgeschlossener SDK-Schritt

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.To publish a self-contained deployment (SCD), configure SCD in the Publish step and provide the Runtime Identifier (RID).

Veröffentlichung einer eigenständigen Bereitstellung

Bereitstellen einer eigenständigen Vorschau-AppDeploy a self-contained preview app

Eine eigenständige Bereitstellung, die auf eine Vorschauruntime abzielt, enthält die Vorschauruntime in der Bereitstellung.A self-contained deployment (SCD) that targets a preview runtime carries the preview runtime in the deployment.

Wenn Sie eine eigenständige App bereitstellen, gilt Folgendes:When deploying a self-contained app:

Befolgen Sie die Anweisungen im Abschnitt Bereitstellen einer eigenständigen Vorschau-App.Follow the guidance in the Deploy the app self-contained section.

Verwenden von Docker mit Web-Apps für ContainerUse Docker with Web Apps for containers

Der Docker-Hub enthält die aktuellen Images für die Docker-Vorschauversion.The Docker Hub contains the latest preview Docker images. Die Images können als Basisimage verwendet werden.The images can be used as a base image. Verwenden Sie das Image, und führen Sie wie gewohnt eine Bereitstellung für Web-Apps für Container durch.Use the image and deploy to Web Apps for Containers normally.

Installieren der Websiteerweiterung (Vorschau)Install the preview site extension

Sollte ein Problem mit dem Verwenden der Vorschau der Websiteerweiterung auftreten, öffnen Sie ein dotnet/AspNetCore-Issue.If a problem occurs using the preview site extension, open an dotnet/AspNetCore issue.

  1. Navigieren Sie im Azure-Portal zu „App Service“.From the Azure Portal, navigate to the App Service.
  2. Wählen Sie die Web-App aus.Select the web app.
  3. Geben Sie „ex“ in das Suchfeld ein, um nach „Extensions“ (Erweiterungen) zu filtern, oder durchsuchen Sie die Liste der Verwaltungstools.Type "ex" in the search box to filter for "Extensions" or scroll down the list of management tools.
  4. Wählen Sie Erweiterungen aus.Select Extensions.
  5. Wählen Sie Hinzufügen aus.Select Add.
  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.Select the ASP.NET Core {X.Y} ({x64|x86}) Runtime extension from the list, where {X.Y} is the ASP.NET Core preview version and {x64|x86} specifies the platform.
  7. Klicken Sie auf OK, um die rechtlichen Bedingungen zu akzeptieren.Select OK to accept the legal terms.
  8. Wählen Sie OK aus, um die Erweiterung zu installieren.Select OK to install the extension.

Nach Abschluss dieses Vorgangs wird die neueste .NET Core-Vorschauversion installiert.When the operation completes, the latest .NET Core preview is installed. Überprüfen Sie die Installation:Verify the installation:

  1. Wählen Sie Erweiterte Tools aus.Select Advanced Tools.

  2. Wählen Sie Go unter Erweiterte Tools aus.Select Go in Advanced Tools.

  3. Wählen Sie das Menüelement Debugkonsole > PowerShell aus.Select the Debug console > PowerShell menu item.

  4. Führen Sie in der PowerShell-Eingabeaufforderung den folgenden Befehl aus.At the PowerShell prompt, execute the following command. Ersetzen Sie im Befehl die ASP.NET Core-Runtimeversion durch {X.Y} und die Plattform durch {PLATFORM}:Substitute the ASP.NET Core runtime version for {X.Y} and the platform for {PLATFORM} in the command:

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

    Der Befehl gibt True zurück, wenn die x64-Vorschauruntime installiert ist.The command returns True when the x64 preview runtime is installed.

Hinweis

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.The platform architecture (x86/x64) of an App Services app is set in the app's settings in the Azure Portal for apps that are hosted on an A-series compute (Basic) or higher hosting tier. Ü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.Confirm that the app's publish settings (for example, in the Visual Studio publish profile (.pubxml)) match the setting in the app's service configuration in the Azure portal.

Wenn die Anwendung im In-Process-Modus ausgeführt wird und die Plattformarchitektur für 64-Bit (x64) konfiguriert ist, verwendet das ASP.NET Core-Modul die 64-Bit-Vorschauruntime, falls vorhanden.If the app is run in in-process mode and the platform architecture is configured for 64-bit (x64), the ASP.NET Core Module uses the 64-bit preview runtime, if present. Installieren Sie die Erweiterung ASP.NET Core {X.Y} (x64) Runtime über das Azure-Portal.Install the ASP.NET Core {X.Y} (x64) Runtime extension using the Azure Portal.

Nach der Installation der x64-Vorschauruntime führen Sie den folgenden Befehl im Azure Kudu PowerShell-Befehlsfenster aus, um die Installation zu überprüfen.After installing the x64 preview runtime, run the following command in the Azure Kudu PowerShell command window to verify the installation. Ersetzen Sie im folgenden Befehl die ASP.NET Core-Runtimeversion für {X.Y}:Substitute the ASP.NET Core runtime version for {X.Y} in the following command:

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

Der Befehl gibt True zurück, wenn die x64-Vorschauruntime installiert ist.The command returns True when the x64 preview runtime is installed.

Hinweis

ASP.NET Core-Erweiterungen aktivieren zusätzliche Funktionen für ASP.NET Core in Azure App Services, z.B. Azure-Protokollierung.ASP.NET Core Extensions enables additional functionality for ASP.NET Core on Azure App Services, such as enabling Azure logging. Die Erweiterung wird automatisch installiert, wenn die Bereitstellung aus Visual Studio erfolgt.The extension is installed automatically when deploying from Visual Studio. Wenn die Erweiterung nicht installiert ist, installieren Sie sie für die App.If the extension isn't installed, install it for the app.

Verwenden der Vorschau-Websiteerweiterung mit einer ARM-VorlageUse the preview site extension with an ARM template

Wenn Sie eine ARM-Vorlage zum Erstellen und Bereitstellen von Anwendungen verwenden, können Sie den Ressourcentyp siteextensions verwenden, um die Websiteerweiterung zu einer Web-App hinzuzufügen.If an ARM template is used to create and deploy apps, the siteextensions resource type can be used to add the site extension to a web app. Zum Beispiel:For example:

{
    ...
    "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'))]"
            ]
        }
    ]
}
    

Veröffentlichen und Bereitstellen der AppPublish and deploy the app

Für eine 64-Bit-Bereitstellung:For a 64-bit deployment:

  • Verwenden Sie ein .NET Core SDK mit 64 Bit, um eine 64-Bit-App zu erstellen.Use a 64-bit .NET Core SDK to build a 64-bit app.
  • Legen Sie die Plattform in App Service unter Konfiguration > Allgemeine Einstellungen auf 64 Bit fest.Set the Platform to 64 Bit in the App Service's Configuration > General settings. Die App muss den Serviceplan „Basic“ oder höher verwenden, damit die Bitanzahl der Plattform festgelegt werden kann.The app must use a Basic or higher service plan to enable the choice of platform bitness.

Frameworkabhängige Bereitstellung einer AppDeploy the app framework-dependent

  1. Klicken Sie in der Visual Studio-Symbolleiste auf Erstellen > {Anwendungsname} veröffentlichen, oder klicken Sie mit der rechten Maustaste auf den Projektmappen-Explorer, und klicken Sie dann auf Veröffentlichen.Select Build > Publish {Application Name} from the Visual Studio toolbar or right-click the project in Solution Explorer and select Publish.
  2. Vergewissern Sie sich im Dialogfeld Veröffentlichungsziel auswählen, dass App Service ausgewählt ist.In the Pick a publish target dialog, confirm that App Service is selected.
  3. Wählen Sie Erweitert aus.Select Advanced. Das Dialogfeld Veröffentlichen wird geöffnet.The Publish dialog opens.
  4. Führen Sie im Dialogfeld Veröffentlichen folgende Schritte aus:In the Publish dialog:
    • Überprüfen Sie, ob die Konfiguration Release ausgewählt ist.Confirm that the Release configuration is selected.
    • Öffnen Sie die Dropdownliste Bereitstellungsmodus, und wählen Sie Frameworkabhängig aus.Open the Deployment Mode drop-down list and select Framework-Dependent.
    • Wählen Sie Portierbar für Zielruntime aus.Select Portable as the Target Runtime.
    • Wenn Sie zusätzliche Dateien bei der Bereitstellung entfernen müssen, öffnen Sie Dateiveröffentlichungsoptionen, und aktivieren Sie das Kontrollkästchen, um zusätzliche Dateien am Ziel zu entfernen.If you need to remove additional files upon deployment, open File Publish Options and select the check box to remove additional files at the destination.
    • Klicken Sie auf Speichern.Select Save.
  5. Sie können eine neue Website erstellen oder eine vorhandene aktualisieren, indem Sie die folgenden Anweisungen des Veröffentlichungs-Assistenten befolgen.Create a new site or update an existing site by following the remaining prompts of the publish wizard.

Bereitstellen der App als eigenständige AppDeploy the app self-contained

Nutzen Sie Visual Studio oder die .NET Core-CLI für eine eigenständige Bereitstellung (Self-Contained Deployment, SCD).Use Visual Studio or the .NET Core CLI for a self-contained deployment (SCD).

  1. Klicken Sie in der Visual Studio-Symbolleiste auf Erstellen > {Anwendungsname} veröffentlichen, oder klicken Sie mit der rechten Maustaste auf den Projektmappen-Explorer, und klicken Sie dann auf Veröffentlichen.Select Build > Publish {Application Name} from the Visual Studio toolbar or right-click the project in Solution Explorer and select Publish.
  2. Vergewissern Sie sich im Dialogfeld Veröffentlichungsziel auswählen, dass App Service ausgewählt ist.In the Pick a publish target dialog, confirm that App Service is selected.
  3. Wählen Sie Erweitert aus.Select Advanced. Das Dialogfeld Veröffentlichen wird geöffnet.The Publish dialog opens.
  4. Führen Sie im Dialogfeld Veröffentlichen folgende Schritte aus:In the Publish dialog:
    • Überprüfen Sie, ob die Konfiguration Release ausgewählt ist.Confirm that the Release configuration is selected.
    • Öffnen Sie die Dropdownliste Bereitstellungsmodus, und wählen Sie Eigenständig aus.Open the Deployment Mode drop-down list and select Self-Contained.
    • Wählen Sie die Zielruntime in der Dropdownliste Zielruntime aus.Select the target runtime from the Target Runtime drop-down list. Der Standardwert ist win-x86.The default is win-x86.
    • Wenn Sie zusätzliche Dateien bei der Bereitstellung entfernen müssen, öffnen Sie Dateiveröffentlichungsoptionen, und aktivieren Sie das Kontrollkästchen, um zusätzliche Dateien am Ziel zu entfernen.If you need to remove additional files upon deployment, open File Publish Options and select the check box to remove additional files at the destination.
    • Klicken Sie auf Speichern.Select Save.
  5. Sie können eine neue Website erstellen oder eine vorhandene aktualisieren, indem Sie die folgenden Anweisungen des Veröffentlichungs-Assistenten befolgen.Create a new site or update an existing site by following the remaining prompts of the publish wizard.

Protokolleinstellungen (HTTPS)Protocol settings (HTTPS)

Durch sichere Protokollbindungen können Sie ein Zertifikat festlegen, das verwendet werden soll, wenn über HTTPS auf Anforderungen geantwortet wird.Secure protocol bindings allow you specify a certificate to use when responding to requests over HTTPS. Bindungen erfordern gültige private Zertifikate ( .pfx), die für den angegebenen Hostnamen ausgestellt wurden.Binding requires a valid private certificate (.pfx) issued for the specific hostname. Weitere Informationen finden Sie unter Tutorial: Binden eines vorhandenen benutzerdefinierten SSL-Zertifikats an Azure App Service.For more information, see Tutorial: Bind an existing custom SSL certificate to Azure App Service.

Transformieren von web.configTransform 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.If you need to transform web.config on publish (for example, set environment variables based on the configuration, profile, or environment), see Transformieren von web.config.

Zusätzliche RessourcenAdditional resources

Azure App Service auf Windows Server verwendet Internetinformationsdienste (IIS).Azure App Service on Windows Server uses Internet Information Services (IIS). Die folgenden Artikel gehen auf die zugrunde liegende IIS-Technologie ein:The following topics pertain to the underlying IIS technology: