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โ.