DSNS's Homelab: HA Talos Kubernetes with GitOps

This repository builds and operates my Kubernetes cluster. Argo CD installs/synchronizes everything above the OS from this repo to the cluster.

Anything that isn't colored in the diagram can be changed, as this homelab is platform agnostic. The architecture will continue to evolve as I migrate more applications.

Architecture

Quickstart

Bootstrap is a one-time procedure. Afterwards, every change follows the same loop: edit, push, and Argo CD syncs automatically.

git clone https://github.com/dsnsgithub/homelab/ && cd homelab
# Assumes an existing Talos Kubernetes cluster. To start from scratch, see docs/bootstrap.md.
kubectl apply -f argocd/root-app.yaml

Open the Argo CD UI at https://10.3.3.9.

Applications (currently migrating to the cluster)

In addition to kube-vip, all stateless applications (proxies, VPNs) are replicated across two different nodes to minimize downtime.

	Service	Address	Status
	Minecraft (Velocity proxy)	mc.dsns.dev:25565	Live
	V2Ray VPN	vray.dsns.dev	Live
	Web proxy (Traefik)	*.seung.dev, *.mseung.dev	Live
	Immich	immich.dsns.dev	Migration Planned
	T3 Code Web	code.dsns.dev	Migration Planned
	WireGuard VPN	Not publicly accessible	Potential Migration Planned

Docs

Page	Contents
Bootstrap	Prerequisites and first-time Talos to Argo CD bring-up
Operations	Day-to-day GitOps, growing the cluster, secrets