.NET

1# =============================================================================
2# .NET (ASP.NET Core) Production Dockerfile
3# =============================================================================
4# Customize the following before use:
5#   - PROJECT_NAME: Replace "MyApp" with your .csproj name (without extension)
6#   - PORT:         Change EXPOSE port if not 8080
7#   - ASSEMBLY:     Adjust the DLL name in ENTRYPOINT if it differs from the project
8#
9# Notes:
10#   - .NET 8+ defaults to port 8080 (ASPNETCORE_HTTP_PORTS), not 80
11#   - The "app" user is built into the aspnet runtime image since .NET 8
12#   - For self-contained deployment, add --self-contained to dotnet publish
13#     and switch the runtime image to mcr.microsoft.com/dotnet/runtime-deps:<LATEST_STABLE_DOTNET_ASPNET>
14# =============================================================================
15
16# ---------------------------------------------------------------------------
17# Stage 1: Build
18# ---------------------------------------------------------------------------
19# Base: current .NET LTS (Microsoft official). See references/base-images.md.
20FROM mcr.microsoft.com/dotnet/sdk:<LATEST_STABLE_DOTNET_SDK> AS build
21
22WORKDIR /src
23
24# Layer caching: restore NuGet packages before copying the full source.
25# Copy only project files first so the restore layer is cached independently.
26COPY *.sln ./
27COPY src/MyApp/*.csproj src/MyApp/
28
29RUN dotnet restore src/MyApp/MyApp.csproj
30
31# Copy everything and publish a Release build
32COPY . .
33
34RUN dotnet publish src/MyApp/MyApp.csproj \
35    --configuration Release \
36    --no-restore \
37    --output /app/publish
38
39# ---------------------------------------------------------------------------
40# Stage 2: Runtime
41# ---------------------------------------------------------------------------
42# Base: current .NET LTS (Microsoft official). See references/base-images.md.
43FROM mcr.microsoft.com/dotnet/aspnet:<LATEST_STABLE_DOTNET_ASPNET>
44
45WORKDIR /app
46
47# Copy published output from the build stage
48COPY --from=build /app/publish ./
49
50# AKS Deployment Safeguards DS004: run as non-root.
51# The "app" user is built into the aspnet image since .NET 8.
52USER app
53
54EXPOSE 8080
55
56ENV ASPNETCORE_URLS="http://+:8080" \
57    DOTNET_RUNNING_IN_CONTAINER=true \
58    DOTNET_EnableDiagnostics=0
59
60# No HEALTHCHECK: the aspnet runtime image does not include curl or wget.
61# Kubernetes liveness/readiness probes (configured in deployment.yaml) handle
62# health checking in AKS. For local Docker usage, install wget or add
63# app.MapHealthChecks("/healthz") and use a custom health check binary.
64
65ENTRYPOINT ["dotnet", "MyApp.dll"]