ASP.NET Core hosten en implementeren

Over het algemeen moet u een ASP.NET Core-app implementeren in een hostingomgeving:

• Implementeer de gepubliceerde app in een map op de hostingserver.
• Stel een procesbeheer in waarmee de app wordt gestart wanneer aanvragen binnenkomen en de app opnieuw wordt opgestart nadat deze vastloopt of de server opnieuw wordt opgestart.
• Voor de configuratie van een omgekeerde proxy stelt u een omgekeerde proxy in om aanvragen door te sturen naar de app.

Zie voor host- en implementatierichtlijnen Blazor, die de richtlijnen in dit knooppunt aanvullen of vervangen, Host en implementeer ASP.NET Core Blazor.

Publiceren in een map

Met de dotnet publish-opdracht wordt de app-code gecompileerd en worden de vereiste bestanden gekopieerd die nodig zijn om de app uit te voeren naar een map voor publicatie. Bij het implementeren vanuit Visual Studio vindt de dotnet publish stap automatisch plaats voordat de bestanden naar het implementatiedoel worden gekopieerd.

De gepubliceerde app lokaal uitvoeren

Als u de gepubliceerde app lokaal wilt uitvoeren, voert u dotnet <ApplicationName>.dll uit vanuit de map publiceren.

Instellingenbestanden publiceren

*.json bestanden worden standaard gepubliceerd. Als u andere instellingenbestanden wilt publiceren, geeft u deze op in een <ItemGroup><Content Include= ... /> element in het projectbestand. In het volgende voorbeeld worden XML-bestanden gepubliceerd:

<ItemGroup>
  <Content Include="**\*.xml" Exclude="bin\**\*;obj\**\*"
    CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>

Mapinhoud

De map publiceert, bevat een of meer app-assemblybestanden, afhankelijkheden en optioneel de .NET-runtime.

Een .NET Core-app kan worden gepubliceerd als zelfstandige implementatie of frameworkafhankelijke implementatie. Als de app zelfstandig functioneert, worden de assemblybestanden die de .NET-runtime bevatten, opgenomen in de map voor publicatie. Als de app frameworkafhankelijk is, worden de .NET Runtime-bestanden niet opgenomen omdat de app een verwijzing heeft naar een versie van .NET die op de server is geïnstalleerd. Het standaardimplementatiemodel is frameworkafhankelijk. Zie .NET Core-toepassingsimplementatievoor meer informatie.

Naast .exe- en .dll-bestanden, bevat de map voor een ASP.NET Core-app doorgaans configuratiebestanden, statische assets en MVC-weergaven. Zie ASP.NET Core-directorystructuurvoor meer informatie.

Een procesbeheerder instellen

Een ASP.NET Core-app is een console-app die moet worden gestart wanneer een server wordt opgestart en opnieuw wordt opgestart als deze vastloopt. Als u het starten en opnieuw opstarten wilt automatiseren, is een procesbeheerder vereist. De meest voorkomende procesmanagers voor ASP.NET Core zijn:

• Linux
  • Nginx
• Windows
  • IIS-
  • Windows-service

Een omgekeerde proxy instellen

Als de app gebruikmaakt van de Kestrel-server, kan Nginx-of IIS- worden gebruikt als een omgekeerde proxyserver. Een omgekeerde proxyserver ontvangt HTTP-aanvragen van internet en stuurt deze door naar Kestrel.

Configuratie, met of zonder een omgekeerde proxyserver, is een ondersteunde hostingconfiguratie. Zie Wanneer u Kestrel gebruikt met een omgekeerde proxyvoor meer informatie.

Scenario's voor proxyserver en load balancer

Er is mogelijk extra configuratie vereist voor apps die worden gehost achter proxyservers en load balancers. Zonder extra configuratie heeft een app mogelijk geen toegang tot het schema (HTTP/HTTPS) en het externe IP-adres waar een aanvraag vandaan komt. Zie ASP.NET Core configureren voor gebruik met proxyservers en load balancersvoor meer informatie.

Visual Studio en MSBuild gebruiken om implementaties te automatiseren

Implementatie vereist vaak extra taken, naast het kopiëren van de uitvoer van dotnet publish naar een server. Er kunnen bijvoorbeeld extra bestanden vereist of uitgesloten zijn van de map publiceren. Visual Studio maakt gebruik van MSBuild voor webimplementatie en MSBuild kan worden aangepast om veel andere taken uit te voeren tijdens de implementatie. Voor meer informatie, zie Visual Studio-publicatieprofielen (.pubxml) voor de implementatie van ASP.NET Core-apps en het boek Using MSBuild and Team Foundation Build.

Met behulp van de functie Web publiceren kunnen-apps rechtstreeks vanuit Visual Studio naar de Azure App Service worden geïmplementeerd. Azure DevOps Services ondersteunt continue implementatie naar Azure App Service. Zie DevOps voor ASP.NET Core Developersvoor meer informatie.

Publiceren naar Azure

Zie Een ASP.NET Core-app publiceren naar Azure met Visual Studio voor instructies over het publiceren van een app naar Azure met behulp van Visual Studio. Een extra voorbeeld is Een ASP.NET Core-web-app maken in Azure.

Publiceren met MSDeploy in Windows

Zie Visual Studio-publicatieprofielen (.pubxml) voor ASP.NET Core-app-implementatie voor instructies over het publiceren van een app met een Visual Studio-publicatieprofiel, waaronder vanaf een Windows-opdrachtprompt met behulp van de opdracht dotnet msbuild.

Internet Information Services (IIS)

Zie voor implementaties naar Internet Information Services (IIS) met configuratie geleverd door het web.config-bestand de artikelen onder ASP.NET Core hosten op Windows met IIS.

Hosten in een webfarm

Zie Host ASP.NET Core in een webfarm-voor informatie over de configuratie voor het hosten van ASP.NET Core-apps in een webfarmomgeving (bijvoorbeeld de implementatie van meerdere exemplaren van uw app voor schaalbaarheid).

Host op Docker

Zie Host ASP.NET Core in Docker-containersvoor meer informatie.

Statuscontroles uitvoeren

Gebruik Health Check Middleware om statuscontroles uit te voeren op een app en de bijbehorende afhankelijkheden. Zie Health-controles in ASP.NET Corevoor meer informatie.

Aanvullende informatiebronnen

• overzicht van .NET-toepassingspublicaties
• Problemen met ASP.NET Core-projecten oplossen en fouten opsporen
• ASP.NET Hosting