Release Notes for Containers

.NET Core 2.1

Red Hat Customer Content Services


The .NET Core 2.1 Release Notes for Containers is an extension of the .NET Core 2.1 Release Notes for RPMs. These release notes list changes to the .NET Core 2.1 containers, and The former is the source-to-image builder, and the latter is a runtime-only image.

Chapter 1. New Features in .NET Core 2.1 Containers

The .NET Core 2.1 Release Notes for Containers is an extension of the .NET Core 2.1 Release Notes for RPMs. See .NET Core 2.1 Release Notes for RPMs for information on known issues, the operating system architecture, privacy, and support.

1.1. New Features

  • .NET Core 2.1 runtime image:

  • .NET Core 2.1 source-to-image builder image:

Report a bug

Chapter 2. Environment Variable Updates

The following environment variables have been added or removed for .NET Core 2.1 image.

2.1. New Variables

DOTNET_TOOLS Used to specify a list of .NET tools to install before building the app. It is possible to install a specific version by post pending the package name with @<version>.

2.2. Variables Removed

DOTNET_ASPNET_STORE Publish assuming the runtime image contains the ASP.NET Core runtime store.

See Environment Variables for the list of environment variables available with .NET Core 2.1.

Report a bug

Chapter 3. Known Issues

  1. Build containers for Red Hat Enterprise Linux 7 have been updated to contain the rh-nodejs10 package instead of the rh-nodejs8 package. Support for Node.js 8 will be going end-of-life in December, 2019, and several modules that it installs have security vulnerabilities that will not be fixed. The update to use rh-nodejs10 may break applications that depend on the rh-nodejs8 package. See the Node.js 10 changelog file for more information about relevant changes.
  2. ASP.NET Core applications published as framework-dependent fail to run with dotnet/dotnet-21-runtime-rhel7 because the ASP.NET Core shared framework is missing. See Shared Framework issue in .NET Core 2.1 Release Notes for RPMs for more information.
  3. .NET Core SDK 2.1.3xx contains an incorrect NETStandard.Library version. Using this SDK version may result in build failures. To correct this issue, update to SDK 2.1.402 (or later). To update to the latest SDK version, change the DOTNET_SDK_VERSION environment variable to 2.1.402 (or to the latest preferred SDK version or the setting latest). For more information about this and other environment variables, see Section 2.3., Environment Variables.

    If there is a global.json file that specifies the SDK version and you do not want to update to the latest SDK version, you can work around this issue by removing the following entry in the csproj file.


    See Chapter 7, Known Issues in the .NET Core 2.1 Release Notes for RPMs for a list of known issues and workarounds for RPMs.

Report a bug

Appendix A. Revision History




Les Williams

Generally available



Les Williams

Added new feature about support for building Visual Basic (VB) and F# projects



Les Williams

Generally available



Toby Drake

Added known issue for SDK 2.1.3xx

Report a bug

Legal Notice

Copyright © 2019 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.