Skip to content

Latest commit

 

History

History
107 lines (75 loc) · 3.96 KB

README.md

File metadata and controls

107 lines (75 loc) · 3.96 KB
Raw

.NET Runtime image

This repository contains the source for building a container image that can be used as a base in which to run already built .NET applications.

The container image can be used as a base image using docker/podman. Or you can build an application image using s2i. The image can be run using docker/podman.

Usage

The distributale binaries of an application should be copied to this image and a new docker image should be created using this image as the base.

For example to create an image for s2i-dotnetcore-ex

Publish the application:

$ git clone -b dotnet-9.0 https://github.com/redhat-developer/s2i-dotnetcore-ex.git
$ cd s2i-dotnetcore-ex/app
$ dotnet publish -c Release /p:MicrosoftNETPlatformLibrary=Microsoft.NETCore.App

To create an image using s2i:

$ s2i build bin/Release/net9.0/publish ubi8/dotnet-90-runtime s2i-dotnetcore-ex

To create an image using docker/podman:

$ cat > Dockerfile <<EOF
FROM ubi8/dotnet-90-runtime
ADD bin/Release/net9.0/publish/. .
CMD [ "dotnet", "app.dll" ]
EOF
$ docker build -t s2i-dotnetcore-ex .

Start a container:

$ docker run --rm -p 8080:8080 s2i-dotnetcore-ex

Visit the web application that is running in the container with a browser at [http://localhost:8080].

Repository organization

  • Dockerfile.rhel8

    UBI 8 / RHEL 8 based Dockerfile. No RHEL subscription is required, but without one only UBI RPMs can be added to the container.

  • test/

    This folder contains binary archives of S2I dotnet sample applications.

    • asp-net-hello-world/

      ASP .Net hello world example app used for testing purposes. Sources are precompiled in app.tar.gz. See build-project.sh for as to how to produce the binary.

Environment variables

The following variables are set so they can be used from scripts. They must not to be overridden.

  • ASPNETCORE_URLS

    This variable is set to http://*:8080 to configure ASP.NET Core to use the port exposed by the image.

  • DOTNET_APP_PATH,DOTNET_DEFAULT_CMD,DOTNET_DATA_PATH

    These variables contain the working directory (/opt/app-root/app), the default CMD of the runtime image (default-cmd.sh) and an empty folder you can use to store your application data (/opt/app-root/data) and make persistent with a volume mount.

  • SSL_CERT_DIR

    Used to specify a list of colon (:) separated directories with certificates to trust. To load the default system directory, you can include /etc/ssl/certs. Adding directories that do not exist does not cause errors.

    It's recommended to use absolute paths. If you use an s2i build, you can refer to a directory that is part of the s2i source repository using /opt/app-root/src as the base directory. To refer to a directory that is part of the s2i application, you can use /opt/app-root/app as the base directory. Note that these certificates from the source repository will be loaded when the application runs unless DOTNET_RM_SRC is set to true to remove the application sources from the application image.

    Breaking change Since .NET 9, trusting certificates using DOTNET_SSL_DIRS is no longer supported and SSL_CERT_DIR must be used instead.

  • DOTNET_RUNNING_IN_CONTAINER

    Like Microsoft images, this is set to true and can be used to detect the application is built/running in a container.

  • APP_UID

    Like Microsoft images, this is set to the rootless user's uid to enable switching to that user in a Dockerfile using the the instruction: USER $APP_UID.

  • DOTNET_VERSION, ASPNET_VERSION

    These variables contain the version of the .NET runtime and ASP.NET Core runtime.