openeuler/dotnet-aspnet repository overview

⁠Quick reference

• The official Dotnet-aspnet（ASP.NET Core） docker image.

• Maintained by: openEuler CloudNative SIG⁠.

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

⁠Dotnet-aspnet（ASP.NET Core） | openEuler

Current Dotnet-aspnet（ASP.NET Core） docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

Dotnet-aspnet (ASP.NET Core) is an open source cross-platform framework for building modern cloud-based Internet-connected applications, such as web applications, IoT applications, and mobile backends. ASP.NET Core applications run on .NET.

Learn more about Dotnet-aspnet（ASP.NET Core）（ASP on learn.microsoft.com⁠⁠.

⁠Supported tags and respective Dockerfile links

The tag of each dotnet-aspnet docker image is consist of the version of dotnet-aspnet 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-aspnet image from docker

  docker pull openeuler/dotnet-aspnet:{Tag}
  

  Copy

• Start a dotnet-aspnet instance

  docker run -d --name my-dotnet-aspnet -p 8080:8080 openeuler/dotnet-aspnet:{Tag}
  

  Copy

  After my-dotnet-aspnet is started, access the service through http://localhost:8080.

• An example with HelloWorld application example

  1. Obtain the dotnetcore-docs-hello-world source code and navigate to the root directory.

     git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world
     cd dotnetcore-docs-hello-world
     

     Copy

  2. Modify the .NET Version for Application Publishing Open the dotnetcoresample.csproj file, and replace {x.x} in <TargetFramework>net{x.x}</TargetFramework> with the desired .NET version.

  3. Publish the application.

     dotnet publish -c Release -o /app --self-contained false
     

     Copy

     During execution, the following key information will be displayed:

     Determining projects to restore...
     All projects are up-to-date for restore.
     dotnetcoresample -> /tmp/dotnetcore-docs-hello-world/bin/Release/net{x.x}/dotnetcoresample.dll
     dotnetcoresample -> /app/
     

     Copy

  4. Run the application using openeuler/dotnet-aspnet:{Tag}

     docker run --rm -v /app:/app -p 8080:8080 openeuler/dotnet-aspnet:{Tag} /app/dotnetcoresample.dll 
     

     Copy

     Note: The .NET version {x.x} used for publishing the application must match the version specified by {Tag}.

• View container running logs

  docker logs -f my-dotnet-aspnet
  

  Copy

• To get an interactive shell

  docker run -it --entrypoint /bin/bash --name my-dotnet-aspnet -p 8080:8080 openeuler/dotnet-aspnet:{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⁠.