{"id":35374,"date":"2019-02-27T12:40:03","date_gmt":"2019-02-27T19:40:03","guid":{"rendered":"http:\/\/devblogs.microsoft.com\/premier-developer\/?p=35374"},"modified":"2019-02-25T12:52:24","modified_gmt":"2019-02-25T19:52:24","slug":"running-a-net-core-web-application-in-docker-container-using-docker-desktop-for-windows","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/premier-developer\/running-a-net-core-web-application-in-docker-container-using-docker-desktop-for-windows\/","title":{"rendered":"Running a .NET Core Web Application in Docker container using Docker Desktop for Windows"},"content":{"rendered":"

In this post, App Dev Managers Anand Shukla<\/a> and Sash Kavalaparambi<\/a>l provide step by step instruction to run a .NET Core Web Application in Docker container using Docker Desktop for Windows.<\/p>\n

\n

If you do not have Docker Desktop for Windows already installed, we will need to install it from https:\/\/docs.docker.com\/docker-for-windows\/install\/<\/a> . Please check the system requirements to make sure it is supported on your OS. This will redirect you to https:\/\/hub.docker.com\/editions\/community\/docker-ce-desktop-windows<\/a> where you will need to login, and download the Docker Desktop for Windows. You may have to logout \/ login or restart your system depending on whether Hyper-V is enabled on your system or not.<\/p>\n

Once you have installed Docker Desktop for Windows, you will find the Docker icon in your system tray. You can right click, and access the menu to change some of the settings. As you can see from screen below, we are currently running Linux containers, and can switch to Windows container by clicking the menu option.<\/p>\n

\"cid:image005.png@01D4C511.C832B7F0\"<\/p>\n

\"cid:image007.jpg@01D4C511.C832B7F0\"<\/p>\n

You can access the settings by clicking on Settings and can change some of the behaviors such as \u201cStart Docker Desktop when you log in\u201d<\/p>\n

Now we have our Docker Desktop installed, the next step is to create a new ASP.NET core project. You can use VS Code, command line or Visual Studio to create an ASP.NET core project. I will be using Visual Studio to create a new ASP.NET core project but you can use VS Code or command line to create one as well.<\/p>\n

Click on File -> New Project, and then select ASP.NET Core Web Application from .NET Core template. Enter name as aspnetapp, and choose a location for your application.<\/p>\n

\"cid:image008.png@01D4C511.C832B7F0\"<\/p>\n

Use \u201cWeb Application (Model-View-Controller)\u201d on the next screen and click OK to create the project.<\/p>\n

\"cid:image009.jpg@01D4C511.C832B7F0\"<\/p>\n

Once the project is created, create 2 files (Dockerfile, dockerignore.txt -> to be renamed to .dockerignore) in the project directory. Alternatively, you could have chosen \u201cEnable Docker Support\u201d and Visual Studio would have created these files for you. The Dockerfile contains instruction to build the container image, and .dockerignore file contains content to ignore when building the image.<\/p>\n

Please note that Windows will not allow you to create a file which starts with a dot. That\u2019s why we create the file with name dockerignore.txt and then use the command line to rename it.<\/p>\n

\"cid:image010.jpg@01D4C511.C832B7F0\"<\/p>\n

Put the following in Dockerfile. This files 10 steps which builds the application using a separate image which contains the SDK to build, and packages it with an image which just has the ASP.NET Core runtime. Description for each of these steps is provided when we will run the Docker command to build the image.<\/p>\n

FROM microsoft\/dotnet:sdk AS build-env<\/code><\/p>\n

WORKDIR \/app<\/code><\/p>\n

# Copy csproj and restore as distinct layers<\/code><\/p>\n

COPY *.csproj .\/<\/code><\/p>\n

RUN dotnet restore<\/code><\/p>\n

# Copy everything else and build<\/code><\/p>\n

COPY . .\/<\/code><\/p>\n

RUN dotnet publish -c Release -o out<\/code><\/p>\n

# Build runtime image<\/code><\/p>\n

FROM microsoft\/dotnet:aspnetcore-runtime<\/code><\/p>\n

WORKDIR \/app<\/code><\/p>\n

COPY --from=build-env \/app\/out .<\/code><\/p>\n

ENTRYPOINT [\"dotnet\", \"aspnetapp.dll\"]<\/code><\/p>\n

Put the following in .dockerignore<\/p>\n

bin\\<\/code><\/p>\n

obj\\<\/code><\/p>\n

Open PowerShell, and run the command \u201cdocker build -t aspnetapp .\u201d. The option -t will tag the image with name \u201caspnetapp\u201d.<\/p>\n

\"cid:image011.png@01D4C511.C832B7F0\"<\/p>\n

\"cid:image012.png@01D4C511.C832B7F0\"<\/p>\n

\"cid:image013.png@01D4C511.C832B7F0\"<\/p>\n

\"cid:image014.png@01D4C511.C832B7F0\"<\/p>\n

Here is what happens on each of the step:<\/p>\n

    \n
  1. Step 1\/10: FROM microsoft\/dotnet:sdk AS build-env\nPulls the image with tag \u201csdk\u201d from Microsoft\/dotnet registry on docker hub – https:\/\/hub.docker.com\/r\/microsoft\/dotnet\/tags<\/a><\/p>\n

    \u201cbuild-env\u201d name can be given to the new build stage. This will be used to copy file in the later steps.<\/li>\n

  2. Step 2\/10: WORKDIR \/app\nThe WORKDIR instruction sets the working directory for any RUN, CMD, ENTRYPOINT, COPY and ADD instructions that follow it in the Dockerfile. If the WORKDIR doesn\u2019t exist, it will be created even if it\u2019s not used in any subsequent Dockerfile instruction.<\/li>\n
  3. Step 3\/10: COPY *.csproj .\/\nCopies all CS Project files to the working directory inside the container.<\/li>\n
  4. Step 4\/10: RUN dotnet restore\nThis is the .NET command line which restores all the required Nuget packages to build the project.<\/li>\n
  5. Step 5\/10: COPY . .\/\nThis copies all the content of Visual Studio project into the working directory.<\/li>\n
  6. Step 6\/10: RUN dotnet publish -c Release -o out\nThis step uses .NET CLI to create a release build with output directory as \u201cout\u201d<\/li>\n
  7. Step 7\/10: FROM microsoft\/dotnet:aspnetcore-runtime\nPulls the image with tag \u201caspnetcore-runtime\u201d from Microsoft\/dotnet registry on docker hub – https:\/\/hub.docker.com\/r\/microsoft\/dotnet\/tags<\/a> which provides the minimum components to run an ASP.NET Core Web Application.<\/li>\n
  8. Step 8\/10: WORKDIR \/app\nSame as Step 2 above.<\/li>\n
  9. Step 9\/10: COPY –from=build-env \/app\/out .\nThis copies the content of \/app\/out folder from the \u201cbuild-env\u201d to this net container.<\/li>\n
  10. Step 10\/10: ENTRYPOINT [“dotnet”, “aspnetapp.dll”]\nThis allows the container to run as an executable.<\/li>\n<\/ol>\n

    Now we have our Docker Image created, you can list all the images present by using \u201cdocker images ls\u201d command<\/p>\n

    \"cid:image015.jpg@01D4C511.C832B7F0\"<\/p>\n

    Now let\u2019s go ahead and create a container from the image by using \u201cdocker run -d -p 8080:80 –name myapp aspnetapp\u201d. This command will create a container named myapp from the image aspnetapp, and map port 80 of the container to port 8080 on the host machine.<\/p>\n

    \"cid:image016.jpg@01D4C511.C832B7F0\"<\/p>\n

    Now you can browse to your application by going to http:\/\/localhost:8080<\/a> and see your application running.<\/p>\n

    \"cid:image017.jpg@01D4C511.C832B7F0\"<\/p>\n

    As you can see from steps above, it is very simple and straight forward to get an ASP.NET Core web application running in a Docker container. For more examples, please visit examples on Docker ( https:\/\/docs.docker.com\/engine\/examples\/dotnetcore\/<\/a> ) or ASP.NET Core Website (https:\/\/docs.microsoft.com\/en-us\/aspnet\/core\/host-and-deploy\/docker\/?view=aspnetcore-2.2<\/a>)<\/p>\n","protected":false},"excerpt":{"rendered":"

    App Dev Managers Anand Shukla and Sash Kavalaparambil provide step by step instruction to run a .NET Core Web Application in Docker container using Docker Desktop for Windows.<\/p>\n","protected":false},"author":582,"featured_media":35387,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[80],"tags":[83,29,3],"class_list":["post-35374","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net","tag-net-core","tag-docker","tag-team"],"acf":[],"blog_post_summary":"

    App Dev Managers Anand Shukla and Sash Kavalaparambil provide step by step instruction to run a .NET Core Web Application in Docker container using Docker Desktop for Windows.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/35374","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/users\/582"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/comments?post=35374"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/35374\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media\/35387"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media?parent=35374"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/categories?post=35374"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/tags?post=35374"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}