dotnet-framework-docker/README.samples.md

6.4 KiB

.NET Framework, ASP.NET and WCF Samples

  • dotnetapp
    • docker pull mcr.microsoft.com/dotnet/framework/samples:dotnetapp
  • aspnetapp
    • docker pull mcr.microsoft.com/dotnet/framework/samples:aspnetapp
  • wcfservice
    • docker pull mcr.microsoft.com/dotnet/framework/samples:wcfservice
  • wcfclient
    • docker pull mcr.microsoft.com/dotnet/framework/samples:wcfclient

About

These images contain sample .NET Framework, ASP.NET and WCF applications.

Watch discussions for Docker-related .NET announcements.

Usage

The .NET Framework Docker samples show various ways to use .NET Framework and Docker together.

Container sample: Run a simple application

Type the following command to run a sample console application with Docker:

docker run --rm mcr.microsoft.com/dotnet/framework/samples:dotnetapp

Container sample: Run a web application

Type the following command to run a sample web application with Docker:

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

After the application starts, navigate to http://localhost:8000 in your web browser. You need to navigate to the application via IP address instead of localhost for earlier Windows versions, which is demonstrated in View the ASP.NET app in a running container on Windows.

Container sample: Run WCF service and client applications

Type the following command to run a sample WCF service application with Docker:

docker run -it --rm --name wcfservice_sample mcr.microsoft.com/dotnet/framework/samples:wcfservice

After the container starts, find the IP address of the container instance:

docker inspect --format="{{.NetworkSettings.Networks.nat.IPAddress}}" wcfservice_sample
172.26.236.119

Type the following Docker command to start a WCF client container, set environment variable HOST to the IP address of the wcfservice_sample container:

docker run --name wcfclient_sample --rm -it -e HOST=172.26.236.119 mcr.microsoft.com/dotnet/framework/samples:wcfclient

.NET Framework:

.NET:

Full Tag Listing

Windows Server Core 2022 amd64 Tags

Tag Dockerfile
dotnetapp-windowsservercore-ltsc2022, dotnetapp, latest Dockerfile
aspnetapp-windowsservercore-ltsc2022, aspnetapp Dockerfile
wcfservice-windowsservercore-ltsc2022, wcfservice Dockerfile
wcfclient-windowsservercore-ltsc2022, wcfclient Dockerfile

Windows Server Core 2019 amd64 Tags

Tag Dockerfile
dotnetapp-windowsservercore-ltsc2019, dotnetapp, latest Dockerfile
aspnetapp-windowsservercore-ltsc2019, aspnetapp Dockerfile
wcfservice-windowsservercore-ltsc2019, wcfservice Dockerfile
wcfclient-windowsservercore-ltsc2019, wcfclient Dockerfile

Windows Server Core 2016 amd64 Tags

Tag Dockerfile
dotnetapp-windowsservercore-ltsc2016, dotnetapp, latest Dockerfile
aspnetapp-windowsservercore-ltsc2016, aspnetapp Dockerfile
wcfservice-windowsservercore-ltsc2016, wcfservice Dockerfile
wcfclient-windowsservercore-ltsc2016, wcfclient Dockerfile

Tags not listed in the table above are not supported. See the Supported Tags Policy. See the full list of tags for all supported and unsupported tags.

Support

Lifecycle

Image Update Policy

  • We update the supported .NET Framework images within 12 hours of any updates to their base images (e.g. windows/servercore:ltsc2019, windows/servercore:ltsc2022, etc.).
  • We publish .NET Framework images as part of releasing new versions of .NET Framework including major/minor and servicing.

Feedback

License