Publish And Deploy ASP.NET Core MVC On IIS

Jignesh Trivedi

9y139.7k10100Article

10 Comments

Join the conversation! Your thoughts help the community grow.

Sandip Patil8y ago
I am using same functionality. and its running on the server, but some .css files are not able to call, like bootstrap.css, by default it will be calling from ajax cdn, how to resolved this issue?
Vladimir Ving9y ago
I use Asp.net Core 2 and after publish VIEWS folder is no. I written publishOption in project.json and appsettings.json but it not help. I tested the Asp.net Core 1.1 project and after publish the VIEWS folder is always. (by Default)
- Jignesh Trivedi9y ago
  Hi, This can be taken care only in ASP.net core 1.0 , newer version of asp.net core framework not required this setting. Also newer version is not contain project.json file. All the setting contain by .csproj file
- Jignesh Trivedi9y ago
  Please refer following link to know about the mapping of project.json and .csproj file https://docs.microsoft.com/en-us/dotnet/core/tools/project-json-to-csproj
- Vladimir Ving9y ago
  I read this article. I had tried to add different variants "include" in my csproj file, but get exception: "Duplicate 'Content' items were included. The .NET SDK includes 'Content' items from your project directory by default". for example: <ItemGroup> <Content Include="Views\Home\Contact.cshtml" /> </ItemGroup> If I exclude this file, project will be published, but Views folder and Contact.cshtml are still no. How Can I In Asp.net Core 2 include VIEWS Folder (for IIS Published)? i don't understand
malathi puttaiah9y ago
Want to launch .net core app to third party server somee.com , getting HTTP Error 500.19 - Internal Server Error. Can i get help urgently.
- Jignesh Trivedi9y ago
  Hope you follow all the steps mention in this article. Enable tracing and find out error description. From the error description we can find out problem.
John Radley9y ago
Thanks for your article. Although my specific interest is ASP.NET Core on Linux with Nginx. your article is very helpful in understanding the new ASP.NET Core technology.Thx again John
Manav Pandya9y ago
Thanks for sharing this sir Jignesh Trivedi

Introduction

ASP.NET Core is able to run as a standalone Application (out of process Console Application). It does not host inside IIS, which does not require IIS to run an application. ASP.NET Core app has its own self-hosted Web Server and processes the requests, which internally use the self-hosted Server instance. ASP.NET Core uses Kestrel Server to host the core Application but it does not support all the features of the Server such as IIS.

In older ASP.NET Web applications, everything is hosted inside IIS Worker process, which can also refer to an Application pool. The Application Pool hosts our Web Application and our Web Application is instantiated by the built-in ASP.NET hosting features in IIS. The ASP.NET Core Application does not run in the IIS worker process but runs as a separate out of process Console Application, which runs its own Web Server, using Kestrel Web Server. If we run on Windows, we may want to run Kestrel behind IIS to gain infrastructure features such as port forwarding via host headers, life cycle and certificate management.

ASP.NET Core Application is a standalone console Application that is invoked through the "dotnet" runtime command. It does not load into the IIS worker process but loads in the native IIS module called "AspNetCoreModule" which runs the console application. We need to install the AspNetCoreModule on the Server and it is part of ASP.NET Core Server Hosting Bundle.

All IIS applications are run on application pool. For ASP.net core, application pool must set to use No Managed Code. The Application pool acts only as a proxy to forward the requests. There is no need to instantiate a .NET runtime.

The primary job of AspNetCoreModule is to ensure that our Application gets loaded when the first request comes. All incoming Http request are handled by AspNetCoreModule and then it is routed to ASP.NET Core Application. Kestrel picks up the incoming request and passes into ASP.NET Core middleware pipeline that subsequently handles the request and passes to the Application logic, which is the same as the response of the Application which is pushback to the IIS and then Http client.

AspNetCoreModule is configured via the web.config file, which is stored in an Application root folder, which contains the startup command and argument. The dotnet is a startup command and our Application main DLL, which is used to launch application as aargument.

The Web.config file looks, as shown below.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<handlers>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified"/>
</handlers>
<aspNetCore processPath="dotnet" arguments=".\FirstCoreApplication.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>
</system.webServer>
</configuration>

Publishing ASP.NET Core Application

To host our Application on IIS, we first need to publish it. There are two ways to publish .NET Core Application

Using CLI command dotnet publish.
Using Visual Studio Publishing feature.

Before publishing ASP.NET Core Application, we make sure that we are including all the required folders in PublishOptions node of project.json file. This node looks, as shown below.

"publishOptions": {
"include": [
"Views",
"web.config"
]
}

Using CLI command “dotnet publish”

.NET Core Application also supports CLI. Using CLI tool, we can create, build and publish the .NET Core Application. The "dotnet publish" command compiles the Application and publishes the Application with the project dependencies (specified in project.json file) and puts it into a specified folder.

>dotnet publish

Using Visual Studio Publishing feature

To publish our application, using Visual Studio, the first step is to right click on the project which we want to to publish and select publish option. Next step is to select custom option and enter the profile name. Once the profile is created, we need to select publishing method. Here, we have four different publishing methods, namely File system, Web deploy, Web deploy pack and FTP. In this example, I have selected File System as publish option and also need to pass target location.

In the next step, we can select the configuration, target framework and some other publish option. When we click Publish button, Visual Studio publish requires file in to the selected folder.

Host publish folder on IIS Manually

To host ASP.NET Core Application on IIS, we must have Windows 7 or newer / Windows Server 2008 R2 or newer. To configure IIS on Windows machine, we need to turn on some IIS related features of Windows.

Once our Application is published, we can hook up IIS to the published folder. Now, I am going to create a virtual Application directory.

Now, I am creating ASPNETCore Application with .NET runtime "No Managed Code", as shown earlier.

Summary

This article helps us to understand, how to publish and deploy ASP.NET Core Application IIS. ASP.NET Core works on IIS, which is slightly different compared to the classic ASP.NET Application.