Red Hat SummitEste contenido no está disponible en el idioma seleccionado.
Release Notes
Abstract
Chapter 1. Availability
The .NET Core 1.0 framework is a general purpose development platform that has several key features many developers find attractive, including automatic memory management and modern programming languages. These features make it easier to build high-quality apps more efficiently. Multiple implementations of .NET Core are available, based on open .NET Standards that specify the fundamentals of the platform.
This availability allows Windows developers to deploy to Red Hat Enterprise Linux without having to learn Red Hat Enterprise Linux and to expand the reach of workloads to Red Hat Enterprise Linux environments. The goal is to provide a safe introduction to a new environment and culture without risk of exposure. Now users of Red Hat Enterprise Linux and Red Hat Enterprise Linux-based Red Hat products can develop and run .NET Core applications directly on Red Hat Enterprise Linux 7, including Red Hat Enterprise Linux Atomic Host and Red Hat OpenShift Container Platform.
The .NET Core component (rh-dotnetcore10) is packaged as a Software Collection (SCL) and is available for Red Hat Enterprise Linux 7 in the .NET content set. The RPM is yum installable. Full instructions for installing .NET Core 1.0 on Red Hat Enterprise Linux 7 is available in the .NET Core 1.0 Getting Started Guide.
The .NET Core 1.0 platform is available in S2I-compatible docker-formatted containers and for OpenShift Container Platform. Instructions for using .NET Core 1.0 in containers are available in the .NET Core 1.0 .NET Core 1.0 Getting Started Guide.
Chapter 2. .NET Core Overview
The .NET Core platform is a general purpose development platform featuring automatic memory management and modern programming languages. It allows users to build high-quality applications efficiently. The .NET Core platform is available in Red Hat Enterprise Linux (RHEL 7) and OpenShift Container Platform via certified containers.
The .NET Core platform offers:
- the ability to follow a microservices-based approach, where some components are built with .NET and others with Java, but all can run on a common, supported platform in Red Hat Enterprise Linux and OpenShift Container Platform.
- the capacity to more easily develop new .NET Core workloads on Microsoft Windows. Customers can deploy and run on either Red Hat Enterprise Linux or Windows Server.
- a heterogeneous datacenter, where the underlying infrastructure is capable of running .NET applications without having to rely solely on Windows Server.
- access to many of the popular development frameworks, such as .NET, Java, Ruby, and Python from within OpenShift Container Platform.
Chapter 3. New Features
The .NET Core 1.0 image, dotnet/dotnetcore-10-rhel7, now supports the following environment variables:
- HTTP_PROXY
- HTTPS_PROXY
- NPM_MIRROR
- DOTNET_STARTUP_PROJECT
- DOTNET_PUBLISH
- DOTNET_ASSEMBLY_NAME
- DOTNET_RESTORE_SOURCES
- DOTNET_NPM_TOOLS
- DOTNET_TEST_PROJECTS
- DOTNET_CONFIGURATION
ASPNETCORE_URLS
See the .NET Core 1.0 Getting Started Guide for more details
Two image templates are available:
- A sample app, redhat-developer/s2i-dotnetcore-ex, is now the primary sample application. It provides a more exciting example than the simple "Hello World" app we used previously.
Chapter 4. Customer Privacy
Various Microsoft products have a feature that reports usage statistics, analytics, and various other metrics to Microsoft over the network. They call this Telemetry. Red Hat is disabling telemetry because we do not recommend sending customer data to anyone without an explicit permission.
As part of the scl enable command, we automatically set an environment variable that tells the CLI to disable its telemetry reporting. Any customer that uses scl enable to run .NET Core will not report telemetry information to Microsoft. This helps keep customer information confidential. Customers are free to override the environment variable after using scl enable to report telemetry, if they wish.
Customers can enable telemetry by unsetting the environment variable DOTNET_CLI_TELEMETRY_OPTOUT. See .NET Core Tools Telemetry for more information.
Chapter 5. Support
The .NET Core 1.0 Getting Started Guide focuses on helping Windows and Linux developers understand what’s required to stand up .NET Core 1.0 on Red Hat Enterprise Linux and complete a basic Hello World! validation to prove that the environment is operational.
The guide’s scope is limited to the minimum information needed to successfully install the .NET Core 1.0 framework on Red Hat Enterprise Linux 7; it is not intended to teach Linux. The assumption is that many Windows developers won’t have extensive Linux experience, so extra assistance deploying software to a Red Hat Enterprise Linux environment will be necessary. See Red Hat Enterprise Linux documentation to learn more about Red Hat Enterprise Linux system administration. When applicable, we can advise the developer to get help from an experienced Linux System Administrator on topics such as understanding Red Hat Enterprise Linux Server 7 components, architecture, permissions, security, file systems, and storage.
Documentation to support Linux developers focuses on setting up .NET Core 1.0 on Red Hat Enterprise Linux 7 and confirming the installation with a Hello World! output. It also provides a quick overview of .NET Core 1.0 with a link to microsoft.com learning resources. Several key motivations include the breadth of the .NET Core market for hosting workloads previously limited to Linux environments and the extent of .NET Core documentation and learning resources. Staffing options now extend to developers without previous Linux experience. One challenge includes understanding the basics of .NET Core architecture and requirements. It is also reasonable to assume the Windows developer tools, interfaces, conventions, and sources of information may be unfamiliar to Linux developers.
5.1. .NET Core 1.0 Support Overview
Red Hat and Microsoft are committed to providing excellent support for .NET Core and are working together to resolve any problems that come up from either side. At a high level, Red Hat supports the installation, configuration, and running of the .NET Core component in Red Hat OpenShift Container Platform and Red Hat Enterprise Linux. If it’s a runtime issue, we’re responsible for getting the customer an answer. Red Hat can also provide "commercially reasonable" support for issues we can help with, for instance, NuGet access problems, permissions issues, firewalls, and application questions that we might know the answer to. If it’s a defect or vulnerability in .NET Core, we let Microsoft know about it.
.NET Core 1.0 is supported on Red Hat Enterprise Linux 7 and OpenShift Container Platform versions 3.3 and later.
5.2. Length of Support
Developers can use either the Long Term Support (LTS) releases or Current releases. LTS releases are normally major releases (for example, 1.0) and only receive critical fixes. Current releases are minor releases (for example, 1.0.x) and receive the same fixes. They will also be revised when compatible innovations and features are available.
LTS releases are supported for 3 years after the general availability date or 1 year after the general availability of a subsequent LTS release.
According to Microsoft, Current releases are supported within the same 3-year window as the parent LTS release. They are supported for 3 months after the general availability of a subsequent Current release and 1 year after the general availability of a subsequent LTS release. See Microsoft’s .NET Core Support Lifecycle Fact Sheet for more details.
5.3. Who Do I Contact?
There are a couple of ways you can get support, depending on how you are using .NET Core.
- If you are using .NET Core on-premise, you can contact either Red Hat Support or Microsoft directly.
- If you using .NET Core in Microsoft Azure, you can contact either Red Hat Support or Azure Support to receive Integrated Support.
Integrated Support is a collaborative support agreement between Red Hat and Microsoft. Customers using Red Hat products in Microsoft Azure are mutual customers, so both companies are united to provide the best troubleshooting and support experience possible.
5.4. Frequently Asked questions
Here are four of the most common support questions for Integrated Support.
When do I access Integrated Support?
You can engage Red Hat Support directly. If the Red Hat Support Engineer assigned to your case needs assistance from Microsoft, the Red Hat Support Engineer will collaborate with Microsoft directly without any action required from you. Likewise on the Microsoft side, they have a process for directly collaborating with Red Hat Support Engineers.
What happens after I file a support case?
Once the Red Hat support case has been created, a Red Hat Support Engineer will be assigned to the case and begin collaborating on the issue with you and your Microsoft Support Engineer. You should expect a response to the issue based on Red Hat’s Production Support Service Level Agreement.
What if I need further assistance?
Contact Red Hat Support for assistance in creating your case or with any questions related to this process. You can view any of your open cases here.
How do I engage Microsoft for support for a Microsoft Azure platform issue?
If you have support from Microsoft, you can open a case using whatever process you typically would follow. If you don’t have support with Microsoft, you can always get support from Microsoft here.
5.5. More Support Resources
The Resources page at Red Hat Developers provides a wealth of information, including:
- Getting started documents
- Knowledgebase articles and solutions
- Blog posts
The .NET Runtime for Red Hat Enterprise Linux Forum is a great place to interact with other [ProductName] developers.
You can also see more support policy information at Red Hat and Microsoft Azure Certified Cloud & Service Provider Support Policies.
Chapter 6. Known Issues
The known issues for running .NET Core on Red Hat Enterprise Linux include:
- Use Red Hat Enterprise Linux 7 to run .NET Core; it will not run on earlier versions of Red Hat Enterprise Linux.
If you encounter problems with publishing self-contained applications on Red Hat Enterprise Linux 7 for other platforms where the errors clearly talk about libuv, use this workaround.
rm -rf ~/.nuget/packages/Libuv
rm -rf ~/.nuget/packages/LibuvCopy to Clipboard Copied! Toggle word wrap Toggle overflow This will delete the Red Hat-built libuv nuget package and let dotnet download (on the next run) the Microsoft-built libuv package that includes libuv built for all the platforms supported by .NET Core.
The .NET Core 1.0 software collection (rh-dotnetcore10) ships with the project.json build system (1.0.0-preview2 SDK). Visual Studio 2017 does not support the project.json build system. Support for the msbuild/csproj build system will be added in the .NET Core 2.0 release.
- Use the installer to install the 1.0.0-preview2 SDK on a Microsoft Windows platform.
To install the 1.0.0-preview2 SDK on non-RHEL Linux:
- follow these instructions to install .NET Core on your system.
add the 1.0.0-preview2 SDK.
cd /tmp wget https://raw.githubusercontent.com/dotnet/cli/rel/1.0.0/scripts/obtain/dotnet-install.sh chmod +x ./dotnet-install.sh ./dotnet-install.sh -v 1.0.0-preview2-1-003177 -i /tmp/dotnet sudo cp -r /tmp/dotnet/sdk/* /opt/dotnet/sdk/
cd /tmp wget https://raw.githubusercontent.com/dotnet/cli/rel/1.0.0/scripts/obtain/dotnet-install.sh chmod +x ./dotnet-install.sh ./dotnet-install.sh -v 1.0.0-preview2-1-003177 -i /tmp/dotnet sudo cp -r /tmp/dotnet/sdk/* /opt/dotnet/sdk/Copy to Clipboard Copied! Toggle word wrap Toggle overflow The
dotnetcommand defaults to using the latest SDK on the system. To explicitly make it use the 1.0.0-preview2 SDK, add a global.json file in your project root.{ "sdk": { "version": "1.0.0-preview2-1-003177" } }{ "sdk": { "version": "1.0.0-preview2-1-003177" } }Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Chapter 7. Revision History
| Date | Version | Author | Changes |
|---|---|---|---|
| 06/24/2016 | 1.0 | Les Williams | Original version |
| 07/27/2016 | 1.0 | Les Williams | Revised version number to reflect top-level version and spelled out RHEL |
| 08/29/2016 | 1.0 | Les Williams | Removed Step 8 and removed command outputs from Steps 9, 11, 14, 15, and 16 |
| 09/23/2016 | 1.0 | Les Williams | Revised the link for Common Language Runtime (CLR) and added a link for Common Language Infrastructure (CLI) |
| 11/7/2016 | 1.0 | Les Williams | Added references to Red Hat Enterprise Linux 7 Workstation and added a link for permanently enabling rh-dotnetcore10 bash |
| 11/15/2016 | 1.0 | Les Williams | Replaced link with the command to permanently enabling rh-dotnetcore10 bash |
| 12/06/2016 | 1.0 | Les Williams | Added RHEL variants to Step 1 |
| 03/23/2017 | 1.0.4 | Les Williams | Added environment variables and more support information |
| 04/04/2017 | 1.0.4 | Les Williams | Revised to add image templates and a sample app |
| 04/26/2017 | 1.0.4 | Les Williams | Revised to include build system support information |
| 05/16/2017 | 1.0.5 | Les Williams | Revised to include three new environment variables |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}