# jbaltikauskas/dotnet-production-dockerfiles architecture

> Architecture diagram of the GitHub repository jbaltikauskas/dotnet-production-dockerfiles, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jbaltikauskas/dotnet-production-dockerfiles
- Repository: https://github.com/jbaltikauskas/dotnet-production-dockerfiles

## Overview

This repository provides .NET 10 production base-image examples and supporting diagnostic-tool/image-build scripts. The documented user workflow is to choose a base (Alpine by default, Ubuntu Noble for glibc compatibility, or Chiseled when strict distroless policy requires it), build the company image, then use it as the base for an application image that adds published artifacts. Relationships below are limited to those stated in the README; source excerpts were not provided, so script-level calls are not inferred.

Main entry points: [`.ps/Diagnostics-Tools-Build/Core`](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/tree/main/.ps/Diagnostics-Tools-Build/Core) (Tool Image Build Helpers), [`dockerfiles/alpine/10/Dockerfile`](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/alpine/10/Dockerfile) (Alpine Base), [`dockerfiles/ubuntu/10/Dockerfile`](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu/10/Dockerfile) (Ubuntu Noble Base), [`dockerfiles/ubuntu-chiseled/10/Dockerfile`](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu-chiseled/10/Dockerfile) (Chiseled Base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bases["Base Image Variants"]
  node_alpine["Alpine Base"]
  node_ubuntu["Ubuntu Noble Base"]
  node_chiseled["Chiseled Base"]
end

subgraph group_diagnostics["Diagnostic Tools"]
  node_diagnostic_tools["Diagnostic Tools Build<br/>[DotNet-Tools.ps1]"]
  node_tool_images["Tool Image Build Helpers<br/>[Core]"]
end

subgraph group_build["Image Build"]
  node_image_scripts["Image Build Scripts<br/>[Core]"]
  node_image_entrypoints["Image Build Entrypoints"]
end

node_developer(("Platform / App Developer"))
node_microsoft_runtime["Microsoft .NET Runtime"]
node_application(("Application Publisher"))
node_app_image["Application Image"]
node_registry[("Container Registry")]

node_developer -->|"chooses default"| node_alpine
node_developer -->|"chooses alternative"| node_ubuntu
node_developer -->|"chooses lockdown"| node_chiseled
node_alpine -->|"extends runtime"| node_microsoft_runtime
node_ubuntu -->|"extends runtime"| node_microsoft_runtime
node_chiseled -->|"extends runtime"| node_microsoft_runtime
node_diagnostic_tools -.->|"produces tools"| node_tool_images
node_tool_images -->|"copies merged tools"| node_alpine
node_tool_images -->|"copies merged tools"| node_ubuntu
node_tool_images -->|"copies merged tools"| node_chiseled
node_image_entrypoints -.->|"invokes build"| node_image_scripts
node_application -->|"publishes artifacts"| node_app_image
node_alpine -->|"provides base"| node_app_image
node_ubuntu -->|"provides base"| node_app_image
node_chiseled -->|"provides base"| node_app_image
node_app_image -->|"publishes image"| node_registry

click node_alpine "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/alpine/10/Dockerfile"
click node_ubuntu "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu/10/Dockerfile"
click node_chiseled "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu-chiseled/10/Dockerfile"
click node_diagnostic_tools "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/.ps/Diagnostics-Tools-Build/DotNet-Tools.ps1"
click node_tool_images "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/tree/main/.ps/Diagnostics-Tools-Build/Core"
click node_image_scripts "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/tree/main/.ps/ImageBuild/Core"
click node_image_entrypoints "https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/Image-Build-All.ps1"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_alpine,node_ubuntu,node_chiseled toneBlue
class node_diagnostic_tools,node_tool_images,node_registry toneAmber
class node_image_scripts,node_image_entrypoints toneMint
class node_developer,node_microsoft_runtime,node_application,node_app_image toneIndigo
```

## Components

### Base Image Variants

- [Alpine Base](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/alpine/10/Dockerfile): `dockerfiles/alpine/10/Dockerfile`
- [Ubuntu Noble Base](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu/10/Dockerfile): `dockerfiles/ubuntu/10/Dockerfile`
- [Chiseled Base](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/dockerfiles/ubuntu-chiseled/10/Dockerfile): `dockerfiles/ubuntu-chiseled/10/Dockerfile`

### Diagnostic Tools

- [Diagnostic Tools Build](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/.ps/Diagnostics-Tools-Build/DotNet-Tools.ps1): `.ps/Diagnostics-Tools-Build/DotNet-Tools.ps1`
- [Tool Image Build Helpers](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/tree/main/.ps/Diagnostics-Tools-Build/Core): `.ps/Diagnostics-Tools-Build/Core`

### Image Build

- [Image Build Scripts](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/tree/main/.ps/ImageBuild/Core): `.ps/ImageBuild/Core`
- [Image Build Entrypoints](https://github.com/jbaltikauskas/dotnet-production-dockerfiles/blob/main/Image-Build-All.ps1): `Image-Build-All.ps1`

### Other components

- **Platform / App Developer**
- **Microsoft .NET Runtime**
- **Application Publisher**
- **Application Image**
- **Container Registry**

## Connections

- Platform / App Developer → Alpine Base: chooses default (evidence: `README.md`)
- Platform / App Developer → Ubuntu Noble Base: chooses alternative (evidence: `README.md`)
- Platform / App Developer → Chiseled Base: chooses lockdown (evidence: `README.md`)
- Alpine Base → Microsoft .NET Runtime: extends runtime (evidence: `README.md`)
- Ubuntu Noble Base → Microsoft .NET Runtime: extends runtime (evidence: `README.md`)
- Chiseled Base → Microsoft .NET Runtime: extends runtime (evidence: `README.md`)
- Diagnostic Tools Build → Tool Image Build Helpers: produces tools
- Tool Image Build Helpers → Alpine Base: copies merged tools (evidence: `README.md`)
- Tool Image Build Helpers → Ubuntu Noble Base: copies merged tools (evidence: `README.md`)
- Tool Image Build Helpers → Chiseled Base: copies merged tools (evidence: `README.md`)
- Image Build Entrypoints → Image Build Scripts: invokes build
- Application Publisher → Application Image: publishes artifacts (evidence: `README.md`)
- Alpine Base → Application Image: provides base (evidence: `README.md`)
- Ubuntu Noble Base → Application Image: provides base (evidence: `README.md`)
- Chiseled Base → Application Image: provides base (evidence: `README.md`)
- Application Image → Container Registry: publishes image (evidence: `README.md`)
