openeuler/dotnet-runtime repository overview

⁠Quick reference

• The official Dotnet Runtime (.NET Runtime) docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Dotnet Runtime (.NET Runtime) | openEuler

Current Dotnet Runtime (.NET Runtime) docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

.NET is a free, cross-platform, open-source developer platform for building many kinds of applications. It can run programs written in multiple languages, with C# being the most popular. It relies on a high-performance runtime that is used in production by many high-scale apps.

Learn more about Dotnet Runtime on learn.microsoft.com⁠⁠.

⁠Supported tags and respective Dockerfile links

The tag of each dotnet-runtime docker image is consist of the version of dotnet-runtime and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/dotnet-runtime image from docker

  docker pull openeuler/dotnet-runtime:{Tag}
  

  Copy

• Start a dotnet-runtime instance

  docker run -d --name my-dotnet-runtime openeuler/dotnet-runtime:{Tag}
  

  Copy

• An example with HelloWorld application example

  1. Create a HelloWorld.csproj file with the following content

     <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
      	  <OutputType>Exe</OutputType>
      	  <TargetFramework>net8.0</TargetFramework>
      	  <ImplicitUsings>enable</ImplicitUsings>
      	  <Nullable>enable</Nullable>
       </PropertyGroup>
     </Project>
     

     Copy

  2. Create a Program.cs file with the following code

      Console.WriteLine("Hello, World!");
     

     Copy

  3. Publish the .NET application (you need the "dotnet8" package)

      dotnet publish -c Release -o app
     

     Copy

  4. Run the app with "openeuler/dotnet-runtime:8.0.3-oe2203sp3"

      docker run --rm -v $PWD/app:/app openeuler/dotnet-runtime:8.0.3-oe2203sp3 /app/HelloWorld.dll 
      Hello, World!
      
     

     Copy

• View container running logs

  docker logs -f my-dotnet-runtime
  

  Copy

• To get an interactive shell

  docker run -it --entrypoint /bin/bash --name my-dotnet-runtime openeuler/dotnet-runtime:{Tag}
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.