Skip to content

.NET Core 2.1 Docker Image Updates #71

@MichaelSimons

Description

@MichaelSimons

.NET Core 2.1 Docker Image Updates

We have consolidating the set of Docker Hub repositories that we use for .NET Core and ASP.NET Core. We will use microsoft/dotnet as the only repository that we publish to for .NET Core 2.1 and later releases.

We added a set of environment variables to .NET Core images to make it easier to host ASP.NET Core sites at any .NET Core image layer and to enable dotnet watch in SDK container images without additional configuration.

Alpine and ARM32 image variants have been added and are supported.

.NET Core Docker Samples have been moved to the dotnet/dotnet-docker repo. The samples have been updated for .NET Core 2.1. New samples have been added, including Hosting ASP.NET Core Images with Docker over HTTPS.

Discussion

Please share your thoughts on this change and see what others are saying at:

Details

The following changes have been made as part of the .NET Core 2.1 release.

Repo consolidation

.NET Core and ASP.NET Core images will be published to the microsoft/dotnet Docker Hub repo for .NET Core 2.1 and later releases. Co-location of images improves image discovery. The .NET Core runtime and SDK images are already co-located. We are adding the ASP.NET Core runtime images to the microsoft/dotnet repo as a third image type. We are no longer producing the microsoft/aspnetcore-build image with .NET Core 2.1.

The following three tags are now available at the microsoft/dotnet repo:

  • 2.1-sdk
  • 2.1-aspnetcore-runtime
  • 2.1-runtime

Environment variables enable new scenarios

We added a set of environment variables to .NET Core docker images, for .NET Core 2.1 and later. These environment variables enable more scenarios to work without additional configuration, such as developing ASP.NET Core applications in a container.

New sdk image environment variables (example)

  • ASPNETCORE_URLS=http://+:80
  • DOTNET_RUNNING_IN_CONTAINER=true
  • DOTNET_USE_POLLING_FILE_WATCHER=true

New Linux runtime-deps image environment variables (example)

  • ASPNETCORE_URLS=http://+:80
  • DOTNET_RUNNING_IN_CONTAINER=true

New Windows runtime image environment variables (example)

  • ASPNETCORE_URLS=http://+:80
  • DOTNET_RUNNING_IN_CONTAINER=true

New image variants

Alpine and ARM32 image variants have been added and are supported as part of the .NET Core 2.1 release.

For Alpine, you must use specific tags to create Alpine-based images, such as 2.1-runtime-alpine.

For ARM32, you can use the regular multi-arch tags, like 2.1-runtime and 2.1-sdk if you are building on an ARM32 device. If you are building on another type of machine, you need to use ARM32-specific tags for the runtime images you create, such as 2.1-runtime-bionic-arm32v7 (for Ubuntu 18.04).

Related repos

The following repos are related to this announcement:

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions