Skip to content

Latest commit

 

History

History
121 lines (85 loc) · 4.75 KB

README.md

File metadata and controls

121 lines (85 loc) · 4.75 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-8.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/net8.0/publish ubi8/dotnet-80-runtime s2i-dotnetcore-ex

To create an image using docker/podman:

$ cat > Dockerfile <<EOF
FROM ubi8/dotnet-80-runtime
ADD bin/Release/net8.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.

  • DOTNET_SSL_DIRS

    Deprecated Please use SSL_CERT_DIR instead.

    Used to specify a list of space separated (' ') folders/files with additional certificates to trust. The certificates are trusted by each process that runs uring the s2i build and all processes that run in the image after the build (including the application that was built). The items can be absolute paths (starting with /) or paths relative to the source directory (/opt/app-root/src). Defaults to ``.

    Because SSL_CERT_DIR is a well-known OpenSSL variable, it is preferable to use that instead of DOTNET_SSL_DIRS.

    Breaking change Since .NET 8, DOTNET_SSL_DIRS certificates are no longer loaded by an image ENTRYPOINT. Applications that use the default source-to-image (s2i) scripts still load DOTNET_SSL_DIRS automatically. To continue loading these certificates in other cases, you can change to use SSL_CERT_DIR 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.