Getting started with .NET on RHEL 8

Procedure

1. Create a new Console application in a directory called my-app:

   $ dotnet new console --output my-app

   Copy to Clipboard Toggle word wrap

   The 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.

   Copy to Clipboard Toggle word wrap

   A simple Hello World console application is created from a template. The application is stored in the specified my-app directory.

   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

   Copy to Clipboard Toggle word wrap

Procedure

1. Create a new MVC project in a directory called mvc_runtime_example:

   $ dotnet new mvc --output mvc_runtime_example --no-restore

   Copy to Clipboard Toggle word wrap

2. 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

   Copy to Clipboard Toggle word wrap

3. Create 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"]
   EOF

   Copy to Clipboard Toggle word wrap

4. Build your image:

   $ podman build -t dotnet-21-runtime-example .

   Copy to Clipboard Toggle word wrap

5. Run your image:

   $ podman run -d -p8080:8080 dotnet-21-runtime-example

   Copy to Clipboard Toggle word wrap

Procedure

1. If you are a system administrator or otherwise have sufficient permissions, change to the openshift project. Using the openshift project allows you to globally update the image stream definitions.

   $ oc project openshift

   Copy to Clipboard Toggle word wrap

   If you do not have permissions to use the openshift project, you can still update your project definitions starting with Step 2.

2. List all available .NET Core image versions:

   $ oc describe is dotnet -n openshift
   $ oc describe is dotnet

   Copy to Clipboard Toggle word wrap

   The output shows installed images or the message Error from server (NotFound) if no images are installed.

3. Import new image streams:

   $ oc create -f https://raw.githubusercontent.com/redhat-developer/s2i-dotnetcore/master/dotnet_imagestreams_rhel8.json

   Copy to Clipboard Toggle word wrap

   If image streams were already installed, use the replace command to update the image stream definitions.

   $ oc replace -f https://raw.githubusercontent.com/redhat-developer/s2i-dotnetcore/master/dotnet_imagestreams_rhel8.json

   Copy to Clipboard Toggle word wrap

Procedure

1. Create a new OpenShift project:

   $ oc new-project sample-project

   Copy to Clipboard Toggle word wrap

2. Add the ASP.NET Core application:

   $ oc new-app --name=example-app 'dotnet:2.1~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnetcore-2.1' --build-env DOTNET_STARTUP_PROJECT=app

   Copy to Clipboard Toggle word wrap

3. Track the progress of the build:

   $ oc logs -f bc/example-app

   Copy to Clipboard Toggle word wrap

4. View the deployed application once the build is finished:

   $ oc logs -f dc/example-app

   Copy to Clipboard Toggle word wrap

   The application is now accessible within the project.

5. Optional: Make the project accessible externally:

   $ oc expose svc/example-app

   Copy to Clipboard Toggle word wrap

6. Obtain the shareable URL:

   $ oc get routes

   Copy to Clipboard Toggle word wrap

Prerequisites

1. Published application.

   For more information, see Section 2.3, “Publishing applications using .NET Core 2.1”.

Procedure

1. Create a new binary build:

   $ oc new-build --name=my-web-app dotnet:2.1 --binary=true

   Copy to Clipboard Toggle word wrap

2. Start the build and specify the path to the binary artifacts on your local machine:

   $ oc start-build my-web-app --from-dir=bin/Release/netcoreapp2.1/publish

   Copy to Clipboard Toggle word wrap

3. Create a new application:

   $ oc new-app my-web-app

   Copy to Clipboard Toggle word wrap