Session Introduction

Welcome to this module of our Azure Kubernetes Service (AKS) course. In this lesson, you’ll learn how to:

• Scaffold and run a simple ASP.NET Core Razor Pages application
• Containerize the app using Docker Desktop
• Optionally pull a pre-built image from Docker Hub

The Docker image you build here will be deployed to Azure in a later lesson.

Prerequisites

Make sure you have the following installed:

1. Creating the ASP.NET Core Application

We'll scaffold a basic Razor Pages app and review the IndexModel class. Create a new project and replace the contents of Pages/Index.cshtml.cs with:

using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Extensions.Logging;

namespace KodeKloudApp.Pages
{
    public class IndexModel : PageModel
    {
        private readonly ILogger<IndexModel> _logger;

        public IndexModel(ILogger<IndexModel> logger)
        {
            _logger = logger;
        }

        public void OnGet()
        {
        }
    }
}

This minimal page model logs requests and serves the Razor Page on HTTP GET.

2. Containerizing with Docker

At the root of your ASP.NET project, add a Dockerfile similar to:

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY . .
RUN dotnet restore
RUN dotnet publish -c Release -o /app

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY --from=build /app .
ENTRYPOINT ["dotnet", "KodeKloudApp.dll"]

Build the Docker image:

docker build -t yourrepo/kodekloudapp:latest .

A successful build will output stages like:

[+] Building 12.4s (5/17)
 => CACHED [build 1/7] FROM mcr.microsoft.com/dotnet/sdk:6.0 ...
 => [build 3/7] COPY . .
 => [build 4/7] RUN dotnet restore
 => [build 5/7] RUN dotnet build
 => [build 6/7] RUN dotnet publish
[base 1/2] FROM mcr.microsoft.com/dotnet/aspnet:6.0 ...
...

After completion, you’ll have an image tagged yourrepo/kodekloudapp:latest.

3. Using a Pre-built Image (Optional)

If you’d rather skip local builds, pull the image directly from Docker Hub:

docker pull yourrepo/kodekloudapp:latest

References

• Azure Kubernetes Service Documentation
• Docker Desktop
• ASP.NET Core Documentation