nxd010/k3s-infrastructure — explained in plain English
Analysis updated 2026-05-18
Learn how to stand up a real multi node Kubernetes cluster on your own PC using Hyper-V
Practice setting up GitOps deployments with ArgoCD so a git push automatically deploys to the cluster
Study a working example of Prometheus and Grafana monitoring plus horizontal pod autoscaling under load
| nxd010/k3s-infrastructure | 0xmukesh/docusaurus-tutorial | a15n/andrewscheuermann | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | 2021-12-27 | 2015-01-11 |
| Maintenance | — | Dormant | Dormant |
| Setup difficulty | hard | easy | moderate |
| Complexity | 5/5 | 2/5 | 1/5 |
| Audience | ops devops | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Requires Windows 11 Pro with Hyper-V, 16GB+ RAM, 100GB free storage, and a CPU with virtualization enabled to run three VMs.
This project is a complete, documented example of building a production style Kubernetes infrastructure entirely on your own local hardware, rather than in the cloud. It uses Hyper-V, the virtualization feature built into Windows, to create three virtual machines that form a small Kubernetes cluster using K3s, a lightweight version of Kubernetes, with one control plane machine and two worker machines. On top of that cluster, the project sets up a GitOps deployment pipeline with ArgoCD, meaning that pushing new code to a Git repository automatically triggers a deployment to the cluster with no manual steps, plus a full monitoring stack using Prometheus to collect metrics and Grafana to display them as dashboards. The project also demonstrates automatic scaling. Under a load test of fifty thousand requests, the cluster handled a peak of around three thousand four hundred requests per second with zero failed requests and a mean response time under sixty milliseconds, automatically scaling the running copies of the application up to ten pods as demand increased. Rather than just describing the setup, the README is written as a full step by step guide to reproduce it yourself starting from nothing. It walks through enabling Hyper-V and creating a private virtual network, provisioning three Ubuntu Server virtual machines with a PowerShell script, installing K3s on each machine to form the cluster, setting up a local Docker image registry, building and deploying a sample application, installing ArgoCD for automated Git based deployments, and finally installing the Prometheus and Grafana monitoring stack. Each step includes the exact commands needed, from PowerShell scripts on the Windows host to shell commands run inside each Ubuntu virtual machine. To follow this guide yourself you would need a Windows 11 Pro machine with at least sixteen gigabytes of RAM, one hundred gigabytes of free storage, and a processor with virtualization support enabled, since the whole cluster runs as virtual machines on that single computer. This is best suited for someone who already has some familiarity with servers, networking, and command line tools, since the guide assumes comfort working in PowerShell and Linux terminals.
A documented, reproducible guide to building a production style K3s Kubernetes cluster on local Hyper-V VMs with GitOps and full monitoring.
Mainly JavaScript. The stack also includes Kubernetes, K3s, ArgoCD.
Setup difficulty is rated hard, with roughly 1day+ to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.