# jpetazzo/container.training architecture

> Architecture diagram of the GitHub repository jpetazzo/container.training, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jpetazzo/container.training
- Repository: https://github.com/jpetazzo/container.training

## Overview

Container Training is a repository of instructor-led and self-paced Docker, Swarm, and Kubernetes course materials, hands-on examples, and lab-environment tools. A learner follows course content, exercises with DockerCoins, and progresses to cluster deployment and operations; optional material covers observability and policy. The slides source is assembled from Markdown and YAML, while the autopilot supports exercise and slide control. The map emphasizes documented capabilities; unsampled configurations are represented only at directory level, and uncertain wiring is omitted.

Main entry points: [`dockercoins/worker/worker.py`](https://github.com/jpetazzo/container.training/blob/main/dockercoins/worker/worker.py) (Coin worker), [`slides`](https://github.com/jpetazzo/container.training/tree/main/slides) (Docker, Swarm, Kubernetes courses), [`slides/autopilot/autotest.py`](https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/autotest.py) (Exercise autopilot), [`slides/autopilot/server.js`](https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/server.js) (Slide control server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Course materials"]
  node_courses["Docker, Swarm, Kubernetes courses"]
  node_slide_builder["Slide assembly<br/>[markmaker.py]"]
  node_exercise_runner["Exercise autopilot<br/>[autotest.py]"]
  node_slide_control["Slide control server<br/>[server.js]"]
end

subgraph group_demo["Hands-on demos"]
  node_dockercoins["DockerCoins demo"]
  node_worker["Coin worker<br/>[worker.py]"]
  node_rng["Random-byte service<br/>[rng.py]"]
  node_hasher["Hash service<br/>[hasher.rb]"]
  node_webui["Demo web UI<br/>[webui.js]"]
  node_redis[("Redis state")]
end

subgraph group_operations["Cluster operations"]
  node_k8s_examples["Kubernetes examples"]
  node_admission["Pod admission webhook<br/>[webhook.py]"]
  node_logging["Logging stacks"]
  node_metrics["Metrics stack"]
end

subgraph group_labs["Lab preparation"]
  node_lab_tools["Lab provisioning tools"]
  node_cloud_infra["Cloud and cluster infrastructure"]
end

node_learner(("Learner or instructor"))

node_learner -->|"studies"| node_courses
node_courses -->|"assembled by"| node_slide_builder
node_learner -->|"runs exercises"| node_dockercoins
node_worker -->|"requests bytes"| node_rng
node_worker -->|"submits bytes"| node_hasher
node_worker -->|"updates wallet and counters"| node_redis
node_webui -->|"reads demo state"| node_redis
node_learner -.->|"runs exercises"| node_exercise_runner
node_exercise_runner -->|"syncs slides"| node_slide_control
node_slide_control -->|"broadcasts slide changes"| node_learner
node_learner -->|"practices orchestration"| node_k8s_examples
node_learner -->|"studies optional logging"| node_logging
node_learner -->|"studies optional metrics"| node_metrics
node_learner -->|"prepares lab"| node_lab_tools
node_lab_tools -.->|"provisions infrastructure"| node_cloud_infra

click node_courses "https://github.com/jpetazzo/container.training/tree/main/slides"
click node_slide_builder "https://github.com/jpetazzo/container.training/blob/main/slides/markmaker.py"
click node_exercise_runner "https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/autotest.py"
click node_slide_control "https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/server.js"
click node_dockercoins "https://github.com/jpetazzo/container.training/tree/main/dockercoins"
click node_worker "https://github.com/jpetazzo/container.training/blob/main/dockercoins/worker/worker.py"
click node_rng "https://github.com/jpetazzo/container.training/blob/main/dockercoins/rng/rng.py"
click node_hasher "https://github.com/jpetazzo/container.training/blob/main/dockercoins/hasher/hasher.rb"
click node_webui "https://github.com/jpetazzo/container.training/blob/main/dockercoins/webui/webui.js"
click node_k8s_examples "https://github.com/jpetazzo/container.training/tree/main/k8s"
click node_admission "https://github.com/jpetazzo/container.training/blob/main/webhooks/admission/flask/webhook.py"
click node_logging "https://github.com/jpetazzo/container.training/tree/main/efk"
click node_metrics "https://github.com/jpetazzo/container.training/tree/main/prom"
click node_lab_tools "https://github.com/jpetazzo/container.training/tree/main/prepare-labs"
click node_cloud_infra "https://github.com/jpetazzo/container.training/tree/main/prepare-labs/terraform"

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_courses,node_slide_builder,node_exercise_runner,node_slide_control toneBlue
class node_dockercoins,node_worker,node_rng,node_hasher,node_webui,node_redis toneAmber
class node_k8s_examples,node_admission,node_logging,node_metrics toneMint
class node_lab_tools,node_cloud_infra toneRose
class node_learner toneIndigo
```

## Components

### Course materials

- [Docker, Swarm, Kubernetes courses](https://github.com/jpetazzo/container.training/tree/main/slides): `slides`
- [Slide assembly](https://github.com/jpetazzo/container.training/blob/main/slides/markmaker.py): `slides/markmaker.py`
- [Exercise autopilot](https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/autotest.py): `slides/autopilot/autotest.py`
- [Slide control server](https://github.com/jpetazzo/container.training/blob/main/slides/autopilot/server.js): `slides/autopilot/server.js`

### Hands-on demos

- [DockerCoins demo](https://github.com/jpetazzo/container.training/tree/main/dockercoins): `dockercoins`
- [Coin worker](https://github.com/jpetazzo/container.training/blob/main/dockercoins/worker/worker.py): `dockercoins/worker/worker.py`
- [Random-byte service](https://github.com/jpetazzo/container.training/blob/main/dockercoins/rng/rng.py): `dockercoins/rng/rng.py`
- [Hash service](https://github.com/jpetazzo/container.training/blob/main/dockercoins/hasher/hasher.rb): `dockercoins/hasher/hasher.rb`
- [Demo web UI](https://github.com/jpetazzo/container.training/blob/main/dockercoins/webui/webui.js): `dockercoins/webui/webui.js`
- **Redis state**

### Cluster operations

- [Kubernetes examples](https://github.com/jpetazzo/container.training/tree/main/k8s): `k8s`
- [Pod admission webhook](https://github.com/jpetazzo/container.training/blob/main/webhooks/admission/flask/webhook.py): `webhooks/admission/flask/webhook.py`
- [Logging stacks](https://github.com/jpetazzo/container.training/tree/main/efk): `efk`
- [Metrics stack](https://github.com/jpetazzo/container.training/tree/main/prom): `prom`

### Lab preparation

- [Lab provisioning tools](https://github.com/jpetazzo/container.training/tree/main/prepare-labs): `prepare-labs`
- [Cloud and cluster infrastructure](https://github.com/jpetazzo/container.training/tree/main/prepare-labs/terraform): `prepare-labs/terraform`

### Other components

- **Learner or instructor**

## Connections

- Learner or instructor → Docker, Swarm, Kubernetes courses: studies (evidence: `README.md`)
- Docker, Swarm, Kubernetes courses → Slide assembly: assembled by (evidence: `README.md`)
- Learner or instructor → DockerCoins demo: runs exercises (evidence: `README.md`)
- Coin worker → Random-byte service: requests bytes (evidence: `dockercoins/worker/worker.py`)
- Coin worker → Hash service: submits bytes (evidence: `dockercoins/worker/worker.py`)
- Coin worker → Redis state: updates wallet and counters (evidence: `dockercoins/worker/worker.py`)
- Demo web UI → Redis state: reads demo state (evidence: `dockercoins/webui/webui.js`)
- Learner or instructor → Exercise autopilot: runs exercises
- Exercise autopilot → Slide control server: syncs slides (evidence: `slides/autopilot/autotest.py`)
- Slide control server → Learner or instructor: broadcasts slide changes (evidence: `slides/autopilot/server.js`)
- Learner or instructor → Kubernetes examples: practices orchestration (evidence: `README.md`)
- Learner or instructor → Logging stacks: studies optional logging (evidence: `README.md`)
- Learner or instructor → Metrics stack: studies optional metrics (evidence: `README.md`)
- Learner or instructor → Lab provisioning tools: prepares lab (evidence: `README.md`)
- Lab provisioning tools → Cloud and cluster infrastructure: provisions infrastructure
