Goal: Build, host, and maintain any project without being blocked by infrastructure or DevOps complexity.
My biggest struggle with DevOps tools is not their usage β itβs their language.
These tools often use English technical terms that carry vague or overloaded meanings. The semantics can be confusing or even misleading. When I first encountered words like Terraform, Kubernetes, my brain froze.
Many engineers invent terms to describe abstractions that made sense to them but not necessarily to someone who speak English as their snd language.
So this repository is my way to organise and untangle all of it β not by listing definitions, but by explaining each term semantically, visually, and contextually.
Every concept will have:
- a plain-language explanation,
- a diagram or mental model,
- and a βwhen youβd actually use itβ section.
My goal is to make DevOps understandable for people who think, βI can code, but deployment scares me.β
This is a multi-page DevOps roadmap β think of it as a self-contained textbook or starter kit.
Each page focuses on one layer of running a project β from local development to full production deployment.
| Layer | Topic | Description | Link |
|---|---|---|---|
| 𧩠Foundations | 00_intro.md | What DevOps actually means and how everything fits together | |
| π₯οΈ Local Development | 01_local_dev.md | Tools for running your app locally (Docker, Compose, Makefile) | |
| βοΈ Infrastructure | 02_infrastructure.md | Servers, VMs, and Infrastructure-as-Code (Terraform, Ansible) | |
| π CI/CD Pipelines | 03_cicd.md | Automation for testing and deploying your app (GitHub Actions, GitLab CI) | |
| π¦ Containerisation | 04_containers.md | What containers really are and how Docker fits in | |
| π§ Orchestration | 05_kubernetes.md | Kubernetes de-jargonified: pods, nodes, services, and why they exist | |
| π Secrets & Configs | 06_secrets.md | Managing passwords, keys, and environment variables securely | |
| π Monitoring & Logging | 07_monitoring.md | Observability tools: Prometheus, Grafana, Loki, ELK stack | |
| βοΈ Automation Scripts | 08_scripts.md | Shell scripts and Makefiles that glue everything together | |
| π§° DevOps Toolbox | 09_tool_index.md | A glossary of tools explained in human language | |
| π Example Stacks | 10_examples.md | Real examples: Node + Postgres, Flask + Redis, etc. | |
| 𧩠VSCode Debugger | 11_vscode_debugger.md | Step-through debugging for local and containerised apps | |
| π§βπ» JS/TS Runtime | 12_jsts.md | Understanding JavaScript and TypeScript execution environments | |
| π Backend Communication | 13_backend_comms.md | Real-time data flow: WebSocket, SSE, gRPC, and backend protocols | |
| π€ AI Tech Stack | 14_ai.md | AI ecosystem layers: data, compute, models, deployment, and intelligence | |
| βοΈ AWS Fundamentals | 15_aws.md | AWS architecture: networking, compute, storage, databases, and services | |
| π TypeScript Essentials | 16_typescript.md | TypeScript, Node.js, npm, and modern JavaScript development |
- Pick the topic youβre struggling with β say βKubernetesβ.
- Open its page and read the plain-language explanation.
- Copy templates or configs from the
templates/folder. - Modify them for your project and run
make deploy(or the provided script). - Learn by doing β and understanding why it works.
- De-jargonify everything: every tool is explained by its intent, not its marketing term.
- Bottom-up learning: start from local dev β servers β automation β orchestration.
- Portable templates: each folder has configs you can copy for your own projects.
- Practical focus: no theory without a βwhen and why youβd use thisβ.