Chapter 2. Using .NET Core 2.1 on Red Hat Enterprise Linux 8
Learn how to install .NET Core 2.1 as well as create and publish .NET Core applications.
2.1. Installing .NET Core 2.1 Copy linkLink copied to clipboard!
.NET Core 2.1 is included in the AppStream repositories for RHEL 8. The AppStream repositories are enabled by default on RHEL 8 systems.
You can install the .NET Core 2.1 runtime with the latest 2.1 Software Development Kit (SDK). When a newer SDK becomes available for .NET Core 2.1, you can install it by running sudo yum update.
Prerequisites
Installed and registered RHEL 8 with attached subscriptions.
For more information, see Performing a standard RHEL installation.
Procedure
Install .NET Core 2.1 and all of its dependencies:
$ sudo yum install dotnet-sdk-2.1 -y
Verification steps
Verify the installation:
$ dotnet --infoThe output returns the relevant information about the .NET Core installation and the environment.
2.2. Creating an application using .NET Core 2.1 Copy linkLink copied to clipboard!
Learn how to create a C# hello-world application.
Procedure
Create a new Console application in a directory called
my-app:$ dotnet new console --output my-appThe output returns:
The template "Console Application" was created successfully. Processing post-creation actions... Running 'dotnet restore' on my-app/my-app.csproj... Restoring packages for /home/username/my-app/my-app.csproj... Generating MSBuild file /home/username/my-app/obj/my-app.csproj.nuget.g.props. Generating MSBuild file /home/username/my-app/obj/my-app.csproj.nuget.g.targets. Restore completed in 224.85 ms for /home/username/my-app/my-app.csproj. Restore succeeded.A simple
Hello Worldconsole application is created from a template. The application is stored in the specifiedmy-appdirectory.The directory includes the following files:
$ tree my-app my-app ├── my-app.csproj ├── obj │ ├── my-app.csproj.nuget.dgspec.json │ ├── my-app.csproj.nuget.g.props │ ├── my-app.csproj.nuget.g.targets │ ├── project.assets.json │ └── project.nuget.cache └── Program.cs 1 directory, 7 files
Verification steps
Run the project:
$ dotnet run --project my-appThe output returns:
Hello World!
2.3. Publishing applications using .NET Core 2.1 Copy linkLink copied to clipboard!
.NET Core 2.1 applications can be published to use a shared system-wide version of .NET Core or to include .NET Core.
The following methods exist for publishing .NET Core 2.1 applications:
- Framework-dependent deployment (FDD) - The application uses a shared system-wide version of .NET. When publishing an application for RHEL, Red Hat recommends using FDD, because it ensures that the application is using an up-to-date version of .NET Core, built by Red Hat, that includes a specific set of native dependencies.
- Self-contained deployment (SCD) - The application includes .NET. This method uses a runtime built by Microsoft.
Prerequisites
Existing .NET Core application.
For more information on how to create a .NET Core application, see Section 2.2, “Creating an application using .NET Core 2.1”.
2.3.1. Publishing .NET Core applications Copy linkLink copied to clipboard!
Procedure
Publish the framework-dependent application:
$ dotnet publish my-app -f netcoreapp2.1 -c ReleaseReplace my-app with the name of the application you want to publish.
Optional: If the application is for RHEL only, trim out the dependencies needed for other platforms:
$ dotnet restore my-app -r rhel.8-x64 $ dotnet publish my-app -f netcoreapp2.1 -c Release -r rhel.8-x64 --self-contained false
2.3.2. Publishing ASP.NET applications Copy linkLink copied to clipboard!
When using the Microsoft SDK, ASP.NET Core 2.1 web applications are published with a dependency on the ASP.NET Core shared framework. This is a set of packages that are expected to be available on the runtime system.
When publishing on RHEL, these packages are included with the application. To include the packages using the Microsoft SDK, the MicrosoftNETPlatformLibrary property must be set to Microsoft.NETCore.App in the project file as shown below.
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netcoreapp2.1</TargetFramework>
<MicrosoftNETPlatformLibrary>Microsoft.NETCore.App</MicrosoftNETPlatformLibrary>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore.App" Version="2.1" />
</ItemGroup>
</Project>
This property can be set when publishing the application.
$ dotnet publish -f netcoreapp2.1 -c Release -r rhel.8-x64 --self-contained false /p:MicrosoftNETPlatformLibrary=Microsoft.NETCore.App
2.4. Running .NET Core 2.1 applications in containers Copy linkLink copied to clipboard!
Use the ubi8/dotnet-21-runtime image to run a precompiled application inside a Linux container.
Prerequisites
Preconfigured containers.
The following example uses podman.
Procedure
Create a new MVC project in a directory called
mvc_runtime_example:$ dotnet new mvc --output mvc_runtime_example --no-restoreRestore and publish the project:
$ dotnet restore mvc_runtime_example -r rhel.8-x64 $ dotnet publish mvc_runtime_example -f netcoreapp2.1 -c Release -r rhel.8-x64 --self-contained false /p:MicrosoftNETPlatformLibrary=Microsoft.NETCore.AppCreate the
Dockerfile:$ cat > Dockerfile <<EOF FROM registry.access.redhat.com/ubi8/dotnet-21-runtime ADD bin/Release/netcoreapp2.1/publish/ . CMD ["dotnet", "mvc_runtime_example.dll"] EOFBuild your image:
$ podman build -t dotnet-21-runtime-example .Run your image:
$ podman run -d -p8080:8080 dotnet-21-runtime-example
Verification steps
View the application running in the container:
$ xdg-open http://127.0.0.1:8080