# k8sacademy/fundamentals-handson architecture

> Architecture diagram of the GitHub repository k8sacademy/fundamentals-handson, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/k8sacademy/fundamentals-handson
- Repository: https://github.com/k8sacademy/fundamentals-handson

## Overview

##### Project type and purpose
- This repository is **not** a single application but a **hands-on training course** for Docker and Kubernetes fundamentals. It contains 37 labs (L03-03 through L36-02) plus supporting code samples (`ExampleVotingApp`, Express sites, .NET samples, Python apps, etc.), a setup guide PDF, and a root README.

##### File structure
- Top-level:
- `K8sFundamentals-SetupGuide-V3.pdf` – installation/setup instructions
- `README.md`, `LICENSE`, `.gitignore`
- Directories L03-03 … L36-02: each is a self-contained lab folder with a `Readme.md` and code/config (Dockerfiles, YAML, sample apps).
- Notice patterns:
- **Docker labs** (L04-03 … L10-03) containing Dockerfiles, multi-stage builds, Compose files, sample Node/.NET/Python apps.
- **Kubernetes labs** (L17-02 … L36-02) containing `.yaml` manifests for pods, deployments, services, volumes, etc.
- Key tech: Node.js/Express, Python/Flask, .NET Razor Pages, Docker CLI, Docker Compose, kubectl, VS Code.

##### README insights
- Project is an **introductory course**:
- 6+ hours, 94 lectures, 37 hands-on labs
- Covers containerization (Docker) and orchestration (Kubernetes) locally
- No cloud account needed; everything runs on Docker Desktop / local K8s

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Course Infrastructure Context"
        WS["Trainee Workstation"]:::infra
        VS["VS Code (IDE)"]:::infra
        DD["Docker Desktop"]:::infra
        Hub["Docker Hub"]:::infra
        Repo["Local Code Repo"]:::infra
        Guide["Setup Guide PDF"]:::infra
    end

    WS --> VS
    WS -->|uses CLI / IDE| DD
    VS -->|Docker/K8s Extension| DD
    DD -->|pull/push images| Hub
    WS -->|clones| Repo
    WS -->|views| Guide

    subgraph "ExampleVotingApp Reference Architecture"
        Compose["Docker Compose Orchestrator"]:::infra
        VotePy["Vote Service (Python)"]:::service
        VoteNet["Vote Service (.NET)"]:::service
        ResultNode["Result Service (Node.js)"]:::service
        ResultNet["Result Service (.NET SignalR)"]:::service
        WorkerJava["Worker Service (Java)"]:::service
        WorkerNet["Worker Service (.NET)"]:::service
        Queue["RabbitMQ Queue"]:::queue
        MySQL["MySQL Database"]:::data
    end

    WS -->|HTTP Requests| VotePy
    WS -->|HTTP Requests| VoteNet
    WS -->|WebSocket Updates| ResultNet
    Compose --> VotePy
    Compose --> VoteNet
    Compose --> ResultNode
    Compose --> ResultNet
    Compose --> WorkerJava
    Compose --> WorkerNet
    Compose --> Queue
    Compose --> MySQL
    VotePy -->|enqueue VoteCastEvent| Queue
    VoteNet -->|enqueue VoteCastEvent| Queue
    Queue -->|deliver events| WorkerJava
    Queue -->|deliver events| WorkerNet
    WorkerJava -->|writes votes| MySQL
    WorkerNet -->|writes votes| MySQL
    ResultNode -->|reads results| MySQL
    ResultNet -->|reads results| MySQL

    click Repo "https://github.com/k8sacademy/fundamentals-handson/blob/main/README.md"
    click Repo "https://github.com/k8sacademy/fundamentals-handson/tree/main/L03-03"
    click Repo "https://github.com/k8sacademy/fundamentals-handson/tree/main/L36-02"
    click Guide "https://github.com/k8sacademy/fundamentals-handson/blob/main/K8sFundamentals-SetupGuide-V3.pdf"
    click Compose "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/compose.yaml"
    click Compose "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/docker-compose.yml"
    click VotePy "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/vote/app.py"
    click VotePy "https://github.com/k8sacademy/fundamentals-handson/tree/main/L09-05 Docker Compose - Sample App/vote/Dockerfile"
    click VotePy "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/vote/requirements.txt"
    click VoteNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/vote/dotnet/Vote/Program.cs"
    click VoteNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/vote/dotnet/Vote/Startup.cs"
    click VoteNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/vote/dotnet/Vote/Messaging/VoteCastEvent.cs"
    click VoteNet "https://github.com/k8sacademy/fundamentals-handson/tree/main/L09-05 Docker Compose - Sample App/vote/dotnet/Dockerfile"
    click ResultNode "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/backend/src/index.js"
    click ResultNode "https://github.com/k8sacademy/fundamentals-handson/tree/main/L09-05 Docker Compose - Sample App/backend/Dockerfile"
    click ResultNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/result/dotnet/Result/Hubs/ResultsHub.cs"
    click ResultNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/result/dotnet/Result/Startup.cs"
    click ResultNet "https://github.com/k8sacademy/fundamentals-handson/tree/main/L09-05 Docker Compose - Sample App/result/dotnet/Dockerfile"
    click WorkerJava "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/worker/src/main/java/worker/Worker.java"
    click WorkerJava "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/worker/Dockerfile.j"
    click WorkerNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/worker/dotnet/Worker/Program.cs"
    click WorkerNet "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/worker/dotnet/Worker/Workers/QueueWorker.cs"
    click WorkerNet "https://github.com/k8sacademy/fundamentals-handson/tree/main/L09-05 Docker Compose - Sample App/worker/dotnet/Dockerfile"
    click MySQL "https://github.com/k8sacademy/fundamentals-handson/blob/main/L09-05 Docker Compose - Sample App/db/password.txt"

    classDef infra fill:#f39c12,stroke:#e67e22,color:#000
    classDef service fill:#3498db,stroke:#2980b9,color:#fff
    classDef data fill:#2ecc71,stroke:#27ae60,color:#fff
    classDef queue fill:#9b59b6,stroke:#8e44ad,color:#fff
```
