☸️ Kubernetes for Beginners — SCaLE Workshop

Welcome workshop participants! This repository contains everything you need to follow along with the Kubernetes for Beginners workshop at SCaLE (Southern California Linux Expo).

---

🎯 What You'll Build

By the end of this workshop, you will have:

• ✅ A local Kubernetes cluster running with KIND
• ✅ A real app deployed with Namespaces, Deployments, and Pods
• ✅ A Service exposing your app inside the cluster
• ✅ Traefik Ingress routing external HTTP traffic (installed via Helm)
• ✅ ConfigMaps and Secrets injected into your app as env vars and mounted files
• ✅ Horizontal scaling and zero-downtime rolling updates
• ✅ A rollback strategy for bad deploys

---

🗂️ Workshop Modules

#	Module	Time
0	Pre-Flight Checklist	15 min
1	Containers & Kubernetes Concepts	20 min
2	Creating Your KIND Cluster	20 min
3	Namespaces — Organizing Your Cluster	10 min
4	Deployments — Running Your App	25 min
5	Services — Internal Networking	20 min
6	Ingress — External Traffic Routing with Traefik	25 min
7	ConfigMaps & Secrets	20 min
8	Scaling & Rolling Updates	20 min
9	Bonus: Troubleshooting & Tips	open

---

⚙️ Prerequisites

Tool	Min Version	Install
Docker Desktop	v24+	docs.docker.com/get-docker
kind	v0.23+	kind.sigs.k8s.io
kubectl	v1.29+	kubernetes.io/docs/tasks/tools
helm	v3.14+	helm.sh/docs/intro/install

💡 New to the command line? Check the scripts/ folder for helper shell scripts.

---

🚀 Quick Start

# 1. Clone this repo
git clone https://github.com/faisalcodesinfrastructure/scale23x-k8s-workshop.git
cd scale23x-k8s-workshop

# 2. Create the KIND cluster
kind create cluster --name workshop --config manifests/kind-config.yaml

# 3. Follow the modules in order

---

🧱 Repo Structure

k8s-workshop/
├── README.md                    ← You are here
├── manifests/                   ← All YAML files (apply these!)
│   ├── kind-config.yaml
│   ├── namespace.yaml
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   ├── configmap.yaml
│   └── secret.yaml
├── app/                         ← Demo app source (optional)
│   ├── Dockerfile
│   └── index.html
├── modules/                     ← Step-by-step module guides
│   ├── 00-preflight/
│   ├── 01-concepts/
│   └── ...
├── scripts/                     ← Helper scripts
│   ├── setup.sh
│   ├── teardown.sh
│   └── verify.sh
└── docs/                        ← Extra reference material
    └── kubectl-cheatsheet.md

---

🙌 About

Workshop presented at SCaLE Linux Expo by Faisal, a Principal Technical Consultant Lead at AHEAD, specializing in cloud-native transformations, platform engineering, and enterprise architecture.

A CNCF Ambassador and Platform Engineering Ambassador and organizer of Cloud Native LA.

• 🐦 Questions? Open an Issue
• 💬 Join CNCF Slack — #kubernetes channel
• 📚 Official Kubernetes Docs

🔗 Connect

• 💼 Company: AHEAD
• 🌐 Community: Cloud Native LA
• 🐦 Questions? Open an Issue or reach out on LinkedIn

---

If you found this workshop helpful, consider giving the repo a ⭐ — it helps others find it!