About this homelab
This repository serves as a portfolio and documentation hub for my homelab: deployment manifests, CI pipelines, monitoring dashboards and demo applications. Everything is strictly non-commercial and intended for learning & experimentation.
- Stack: Docker, Kubernetes (minikube), ArgoCD, Jenkins, Prometheus/Grafana
- Networking: Cloudflare Tunnel for external access, NodePort for local dev, iptables DNAT for bridging
- Registry: GHCR (GitHub Container Registry)
Projects & Services
Demo Flask App
Realtime coffee-ordering app (Flask + Socket.IO). Repo & container images linked on GitHub.
CI/CD: Jenkins + ArgoCD
Jenkins builds images and updates manifests → ArgoCD syncs to cluster.
Monitoring
Prometheus server + Alertmanager + Grafana dashboards for cluster & router metrics.
Kubernetes manifests
Kustomize base + overlays for minikube/production, demonstrated with demo app.
Architecture (summary)
High-level: CI builds → GHCR → manifests repo → ArgoCD → minikube. External access provided by Cloudflare Tunnel which proxies hostnames to local ports or to external URLs (hub page).
How subdomains are used:
homelab.int.eu.org— hub (this site)jenkins.homelab.int.eu.org— Jenkins (baremetal)grafana.homelab.int.eu.org— Grafana (Docker)k8s-*— NodePort-mapped K8s services via DNAT
Screenshots (placeholders)
Add actual screenshots here (ArgoCD, Jenkins, Grafana, diagram). For PR include at least two screenshots showing DevOps context.
ArgoCD
Jenkins
Deploy & Notes for maintainers
If you are a maintainer evaluating this PR — root domain will only serve as portfolio. All self-hosted services will be at nested subdomains. I confirm non-commercial use.
Recommended domain JSON (for is-a.dev)
{
"description": "Personal homelab and DevOps portfolio: Kubernetes, ArgoCD, Jenkins, Grafana, Docker, self-hosted apps.",
"owner": {"username": "ritchie229", "email": "rishat.mukhtarov@gmail.com"},
"records": { "CNAME": "ritchie229.github.io" }
}
PR description (copy-paste)
This is my personal DevOps portfolio site (Kubernetes, ArgoCD, Jenkins, Docker, monitoring, homelab setup). Root site will only serve the portfolio; all self-hosted projects will be placed on nested subdomains such as jenkins.homelab.int.eu.org, grafana.homelab.int.eu.org, etc. Website: https://ritchie229.github.io Non-commercial: yes