# badrbettaieb/k8s-demo architecture

> Architecture diagram of the GitHub repository badrbettaieb/k8s-demo, 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/badrbettaieb/k8s-demo
- Repository: https://github.com/badrbettaieb/k8s-demo

## Overview

k8s-demo is a guided Kubernetes lab, not an application runtime: learners apply YAML manifests and observe Kubernetes resources. The documented path runs from Pod exercises through ReplicaSet and Deployment management, then exposes the application with a Service and Ingress. Deployment rolling updates and rollbacks, plus inter-Pod connectivity tests, are important side capabilities. Relationships below reflect the README’s documented architecture and exercises; no source excerpts were provided, so implementation details beyond those descriptions are not inferred.

Main entry points: [`04-service/service-nginx.yml`](https://github.com/badrbettaieb/k8s-demo/blob/main/04-service/service-nginx.yml) (ClusterIP Service), [`02-replicaset/replicaset-nginx.yml`](https://github.com/badrbettaieb/k8s-demo/blob/main/02-replicaset/replicaset-nginx.yml) (ReplicaSet manifest), [`03-deployment/deployment-nginx.yml`](https://github.com/badrbettaieb/k8s-demo/blob/main/03-deployment/deployment-nginx.yml) (Deployment manifest), [`05-ingress/ingress.yml`](https://github.com/badrbettaieb/k8s-demo/blob/main/05-ingress/ingress.yml) (Ingress manifest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workloads["Workloads"]
  node_pod["Pod manifest<br/>[pod-nginx.yml]"]
  node_replicaset["ReplicaSet manifest"]
  node_deployment["Deployment manifest"]
end

subgraph group_networking["Networking"]
  node_service["ClusterIP Service<br/>[service-nginx.yml]"]
  node_ingress["Ingress manifest<br/>[ingress.yml]"]
end

subgraph group_lab["Lab interaction"]
  node_cluster["Kubernetes cluster"]
  node_client(("Temporary test client"))
end

node_learner(("Learner / kubectl"))
node_browser(("External browser"))

node_learner -->|"applies"| node_pod
node_learner -->|"applies"| node_replicaset
node_learner -->|"applies"| node_deployment
node_learner -->|"applies"| node_service
node_learner -->|"applies"| node_ingress
node_pod -->|"declares Pod"| node_cluster
node_replicaset -->|"declares ReplicaSet"| node_cluster
node_deployment -->|"declares Deployment"| node_cluster
node_service -->|"declares Service"| node_cluster
node_ingress -->|"declares Ingress"| node_cluster
node_deployment -->|"manages replicas"| node_replicaset
node_replicaset -->|"maintains instances"| node_pod
node_service -->|"exposes Pods"| node_pod
node_ingress -->|"routes traffic"| node_service
node_client -->|"tests connectivity"| node_service
node_browser -->|"accesses app"| node_ingress
node_learner -->|"updates or rolls back"| node_deployment

click node_pod "https://github.com/badrbettaieb/k8s-demo/blob/main/01-pod/pod-nginx.yml"
click node_replicaset "https://github.com/badrbettaieb/k8s-demo/blob/main/02-replicaset/replicaset-nginx.yml"
click node_deployment "https://github.com/badrbettaieb/k8s-demo/blob/main/03-deployment/deployment-nginx.yml"
click node_service "https://github.com/badrbettaieb/k8s-demo/blob/main/04-service/service-nginx.yml"
click node_ingress "https://github.com/badrbettaieb/k8s-demo/blob/main/05-ingress/ingress.yml"

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_pod,node_replicaset,node_deployment,node_browser toneBlue
class node_service,node_ingress toneAmber
class node_cluster,node_client toneMint
class node_learner toneIndigo
```

## Components

### Workloads

- [Pod manifest](https://github.com/badrbettaieb/k8s-demo/blob/main/01-pod/pod-nginx.yml): `01-pod/pod-nginx.yml`
- [ReplicaSet manifest](https://github.com/badrbettaieb/k8s-demo/blob/main/02-replicaset/replicaset-nginx.yml): `02-replicaset/replicaset-nginx.yml`
- [Deployment manifest](https://github.com/badrbettaieb/k8s-demo/blob/main/03-deployment/deployment-nginx.yml): `03-deployment/deployment-nginx.yml`

### Networking

- [ClusterIP Service](https://github.com/badrbettaieb/k8s-demo/blob/main/04-service/service-nginx.yml): `04-service/service-nginx.yml`
- [Ingress manifest](https://github.com/badrbettaieb/k8s-demo/blob/main/05-ingress/ingress.yml): `05-ingress/ingress.yml`

### Lab interaction

- **Kubernetes cluster**
- **Temporary test client**

### Other components

- **Learner / kubectl**
- **External browser**

## Connections

- Learner / kubectl → Pod manifest: applies (evidence: `README.md`)
- Learner / kubectl → ReplicaSet manifest: applies (evidence: `README.md`)
- Learner / kubectl → Deployment manifest: applies (evidence: `README.md`)
- Learner / kubectl → ClusterIP Service: applies (evidence: `README.md`)
- Learner / kubectl → Ingress manifest: applies (evidence: `README.md`)
- Pod manifest → Kubernetes cluster: declares Pod (evidence: `README.md`)
- ReplicaSet manifest → Kubernetes cluster: declares ReplicaSet (evidence: `README.md`)
- Deployment manifest → Kubernetes cluster: declares Deployment (evidence: `README.md`)
- ClusterIP Service → Kubernetes cluster: declares Service (evidence: `README.md`)
- Ingress manifest → Kubernetes cluster: declares Ingress (evidence: `README.md`)
- Deployment manifest → ReplicaSet manifest: manages replicas (evidence: `README.md`)
- ReplicaSet manifest → Pod manifest: maintains instances (evidence: `README.md`)
- ClusterIP Service → Pod manifest: exposes Pods (evidence: `README.md`)
- Ingress manifest → ClusterIP Service: routes traffic (evidence: `README.md`)
- Temporary test client → ClusterIP Service: tests connectivity (evidence: `README.md`)
- External browser → Ingress manifest: accesses app (evidence: `README.md`)
- Learner / kubectl → Deployment manifest: updates or rolls back (evidence: `README.md`)
