Chapter 4. Publishing applications with .NET 5.0
.NET 5.0 applications can be published to use a shared system-wide version of .NET or to include .NET.
The following methods exist for publishing .NET 5.0 applications:
- Single-file application - The application is self-contained and can be deployed as a single executable with all dependent files contained in a single binary.
- 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, built by Red Hat, that uses a set of native dependencies. These native libraries are part of the rh-dotnet50 Software Collection.
-
Self-contained deployment (SCD) - The application includes .NET. This method uses a runtime built by Microsoft. Running applications outside the
rh-dotnet50Software Collection may cause issues due to the unavailability of native libraries.
Prerequisites
Existing .NET application.
For more information on how to create a .NET application, see Creating an application using .NET.
4.1. Publishing .NET applications
The following procedure outlines how to publish a framework-dependent application.
Procedure
Publish the framework-dependent application:
$ dotnet publish my-app -f net5.0 -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.7-x64 $ dotnet publish my-app -f net5.0 -c Release -r rhel.7-x64 --self-contained false
Enable the Software Collection and pass the application to run the application on a RHEL system:
$ scl enable rh-dotnet50 -- dotnet <app>.dll
You can add the
scl enable rh-dotnet50 — dotnet <app>.dllcommand to a script that is published with the application.Add the following script to your project and update the variable:
#!/bin/bash APP=<app> SCL=rh-dotnet50 DIR="$(dirname "$(readlink -f "$0")")" scl enable $SCL -- "$DIR/$APP" "$@"
To include the script when publishing, add this ItemGroup to the
csprojfile:<ItemGroup> <None Update="<scriptname>" Condition="'$(RuntimeIdentifier)' == 'rhel.7-x64' and '$(SelfContained)' == 'false'" CopyToPublishDirectory="PreserveNewest" /> </ItemGroup>
