dotnet-docker/README.samples.md

6.5 KiB

Featured Tags

  • dotnetapp (Dockerfile)
    • docker pull mcr.microsoft.com/dotnet/samples:dotnetapp
  • aspnetapp (Dockerfile)
    • docker pull mcr.microsoft.com/dotnet/samples:aspnetapp

About

These images contain sample .NET and ASP.NET Core applications.

Watch discussions for Docker-related .NET announcements.

Usage

The .NET Docker samples show various ways to use .NET and Docker together. See Building Docker Images for .NET Applications to learn more.

Container sample: Run a simple application

You can quickly run a container with a pre-built .NET Docker image, based on the .NET console sample.

Type the following command to run a sample console application:

docker run --rm mcr.microsoft.com/dotnet/samples

Container sample: Run a web application

You can quickly run a container with a pre-built .NET Docker image, based on the ASP.NET Core sample.

Type the following command to run a sample web application:

docker run -it --rm -p 8000:80 --name aspnetcore_sample mcr.microsoft.com/dotnet/samples:aspnetapp

After the application starts, navigate to http://localhost:8000 in your web browser.

See Hosting ASP.NET Core Images with Docker over HTTPS to use HTTPS with this image.

Related Repos

.NET:

.NET Framework:

Full Tag Listing

Linux amd64 Tags

Tags Dockerfile OS Version
dotnetapp-buster-slim-amd64, dotnetapp, latest Dockerfile Debian 10
aspnetapp-buster-slim-amd64, aspnetapp Dockerfile Debian 10

Linux arm32 Tags

Tags Dockerfile OS Version
dotnetapp-buster-slim-arm32v7, dotnetapp, latest Dockerfile Debian 10
aspnetapp-buster-slim-arm32v7, aspnetapp Dockerfile Debian 10

Linux arm64 Tags

Tags Dockerfile OS Version
dotnetapp-buster-slim-arm64v8, dotnetapp, latest Dockerfile Debian 10
aspnetapp-buster-slim-arm64v8, aspnetapp Dockerfile Debian 10

Nano Server 2022 amd64 Tags

Tag Dockerfile
dotnetapp-nanoserver-ltsc2022, dotnetapp, latest Dockerfile
aspnetapp-nanoserver-ltsc2022, aspnetapp Dockerfile

Nano Server, version 1809 amd64 Tags

Tag Dockerfile
dotnetapp-nanoserver-1809, dotnetapp, latest Dockerfile
aspnetapp-nanoserver-1809, aspnetapp Dockerfile

You can retrieve a list of all available tags for dotnet/samples at https://mcr.microsoft.com/v2/dotnet/samples/tags/list.

For tags contained in the old dotnet/core/samples repository, you can retrieve a list of those tags at https://mcr.microsoft.com/v2/dotnet/core/samples/tags/list.

Tags not listed in the table above are not supported. See the Supported Tags Policy

Support

Lifecycle

Image Update Policy

  • We update the supported .NET images within 12 hours of any updates to their base images (e.g. debian:buster-slim, windows/nanoserver:ltsc2022, buildpack-deps:bionic-scm, etc.).
  • We publish .NET images as part of releasing new versions of .NET including major/minor and servicing.

Feedback

License