Anderen2 / s2i-dotnetcore

.NET Core OpenShift builder images

.Net Docker image

This repository contains the source for building .Net applications as a reproducible Docker image using source-to-image. The resulting image can be run using Docker.

Usage

To build a simple dotnet-sample-app application using standalone S2I and then run the resulting image with Docker execute:

• For RHEL based image

  $ sudo s2i build git://github.com/redhat-developer/s2i-dotnetcore --context-dir=1.0/test/asp-net-hello-world dotnet/dotnetcore-10-rhel7 dotnet-sample-app
  $ sudo docker run -p 8080:8080 dotnet-sample-app
  

Accessing the application:

HTTP:

$ curl http://127.0.0.1:8080

Repository organization

• Dockerfile.rhel7

  RHEL based Dockerfile. In order to perform build or test actions on this Dockerfile you need to run the action on a properly subscribed RHEL machine.

• root/usr/bin/

  This folder contains common scripts.

• s2i/bin/

  This folder contains scripts that are run by S2I:

  • assemble

    Used to install the sources into the location where the application will be run and prepare the application for deployment

  • run

    This script is responsible for running the application

  • usage

    This script prints the usage of this image.

• contrib/

  This folder contains scripts under the app source tree.

• test/

  This folder contains S2I dotnet sample applications.

  • helloworld/

    .Net Core "Hello World" used for testing purposes by the S2I test framework.

  • qotd/

    .Net Core Quote of the Day example app used for testing purposes by the S2I test framework.

  • dotnetbot/

    .Net Core ASCII art example app used for testing purposes by the S2I test framework.

  • asp-net-hello-world/

    ASP .Net hello world example app used for testing purposes by the S2I test framework.

  • asp-net-hello-world-envvar/

    ASP .Net hello world example app used for testing purposes by the S2I test framework.

Environment variables

To set these environment variables, you can place them as a key value pair into a .s2i/environment file inside your source code repository.

• DOTNET_STARTUP_PROJECT

  Used to select the project to run. This must be the folder containing project.json. Defaults to .. The application is built using the dotnet publish command.

• DOTNET_NPM_TOOLS

  Used to specify a list of npm packages to install before building the app. Defaults to ``.

• DOTNET_TEST_PROJECTS

  Used to specify the list of test projects to run. This must be folders containing project.json. dotnet test is invoked for each folder. Defaults to ``.

• DOTNET_CONFIGURATION

  Used to run the application in Debug or Release mode. This should be either Release or Debug. This is passed to the dotnet publish invocation. Defaults to Release.

• DOTNET_RESTORE_ROOT

  Used to specify the list of projects or project folders to restore. This is passed to the dotnet restore invocation. Defaults to ..

• ASPNETCORE_URLS

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

NPM

Typical modern web applications rely on javascript tools to build the front-end. The image includes npm (node package manager) to install these tools. Packages can be installed by setting DOTNET_NPM_TOOLS and by calling npm install in the build process.