Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
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 Link kopierenLink in die Zwischenablage kopiert!
.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
$ sudo yum install dotnet-sdk-2.1 -y
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification steps
Verify the installation:
dotnet --info
$ dotnet --info
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The output returns the relevant information about the .NET Core installation and the environment.
2.2. Creating an application using .NET Core 2.1 Link kopierenLink in die Zwischenablage kopiert!
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-app
$ dotnet new console --output my-app
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The output returns:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow A simple
Hello World
console application is created from a template. The application is stored in the specifiedmy-app
directory.The directory includes the following files:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification steps
Run the project:
dotnet run --project my-app
$ dotnet run --project my-app
Copy to Clipboard Copied! Toggle word wrap Toggle overflow The output returns:
Hello World!
Hello World!
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3. Publishing applications using .NET Core 2.1 Link kopierenLink in die Zwischenablage kopiert!
.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 Link kopierenLink in die Zwischenablage kopiert!
Procedure
Publish the framework-dependent application:
dotnet publish my-app -f netcoreapp2.1 -c Release
$ dotnet publish my-app -f netcoreapp2.1 -c Release
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace 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
$ dotnet restore my-app -r rhel.8-x64 $ dotnet publish my-app -f netcoreapp2.1 -c Release -r rhel.8-x64 --self-contained false
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3.2. Publishing ASP.NET applications Link kopierenLink in die Zwischenablage kopiert!
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.
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
$ 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 Link kopierenLink in die Zwischenablage kopiert!
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-restore
$ dotnet new mvc --output mvc_runtime_example --no-restore
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Restore 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.App
$ 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.App
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create the
Dockerfile
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow Build your image:
podman build -t dotnet-21-runtime-example .
$ podman build -t dotnet-21-runtime-example .
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Run your image:
podman run -d -p8080:8080 dotnet-21-runtime-example
$ podman run -d -p8080:8080 dotnet-21-runtime-example
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification steps
View the application running in the container:
xdg-open http://127.0.0.1:8080
$ xdg-open http://127.0.0.1:8080
Copy to Clipboard Copied! Toggle word wrap Toggle overflow