• Docker
  • .NET
  • Blazor
  • C#

Display a Docker Build Version

In this Article I will show one way to show the Build or Application version, passing it down through a Docker build.


While developing my applications for the Game Development Platform I wanted an easy to access the build version. Since all of my service applications use Docker as their main artifact deployment pattern, passing in a build-arg and setting an ENV var for the image. This allows for a variety of ways to access the Application Version, and make all of my Dockerfile's have the same structure for each application build.

I have included a sample application, using Blazor as the main hosting framework, that when built and packaged up will show the version that was passed in during the build.

Example Project

Below are a few snippets of code from the project you can find at canhorn/EventHorizon.DeployDockerBuildVersion.

Since we are using an environment variable to hold the Application Version, we can read that from the standard IConfiguration setup provided by Blazor Server. Below we just inject the configuration, and ask for the @Configuration["APPLICATION_VERSION"].

@page "/"
@using Microsoft.Extensions.Configuration

<h1>Hello, Version!</h1>

    Application Version: @Configuration["APPLICATION_VERSION"]

@code {
    public IConfiguration Configuration { get; set; } = null!;

Docker Build
This command will use docker, pass in the BUILD_VERSION argument and tag with the same version to build a docker image.

docker build --build-arg BUILD_VERSION=1.2.3-alpha -t docker-build-version:1.2.3-alpha .

This is the Dockerfile used to set the environment variable (APPLICATION_VERSION) that will get picked up by the application.

# Stage 1 - Publish .NET Project
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS dotnet-build
WORKDIR /source

COPY EventHorizon.DeployDockerBuildVersion.csproj ./

RUN dotnet restore ./EventHorizon.DeployDockerBuildVersion.csproj

COPY . .

RUN dotnet build -c Release --no-restore ./EventHorizon.DeployDockerBuildVersion.csproj

RUN dotnet publish --output /app/ --configuration Release --no-restore --no-build ./EventHorizon.DeployDockerBuildVersion.csproj

# Stage 2 - Runtime
FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS runtime

COPY --from=dotnet-build /app .
ENTRYPOINT ["dotnet", "EventHorizon.DeployDockerBuildVersion.dll"]
Cody's logo image, it is an abstract of a black hole with a white Event Horizon.

Cody Merritt Anhorn

A Engineer with a passion for Platform Architecture and Tool Development.