Yesod Monorepo

Homelab Bazel monorepo powering a self-hosted Kubernetes cluster. Covers infrastructure (Terraform bootstrap, Jsonnet/Tanka manifests for ~20 environments), CI/CD (Forgejo Actions), and experimental workloads (Temporal workflows, ML/AI stack, VSCode extension).

Prerequisites

• Bazel 8.5.1 — pinned in .bazelversion; bazelisk recommended
• tea — Gitea CLI for PR/issue operations
• kubectl — cluster access (required for CI log fetching)
• sops + age — secret management
• yesod CLI — brew install yesod-multitool from the acmcarther/yesod-homebrew-tools tap

Quick Start

# Build everything
bazel build //...

# Run all tests (read-only remote cache)
bazel test --config=dev //...

# Diff a Kubernetes environment against the live cluster
bazel run //k8s/configs/environments/monitoring:monitoring.diff

# Apply an environment
bazel run //k8s/configs/environments/monitoring:monitoring.apply

Cluster Environments

Environments live under k8s/configs/environments/. Key ones:

Environment	Purpose
home	Core cluster config
monitoring	Prometheus + Grafana
authentication	Keycloak
dev	Development services
bazel-cache	Remote Bazel cache (SeaweedFS + BuildBarn)
storage	SeaweedFS distributed storage
media	Media services
game	Game servers
jupyter	Jupyter notebooks
nvidia	GPU workloads

Further Reading

• CLAUDE.md — comprehensive guide to the build system, architecture, tooling, and AI agent workflows
• VENDORING.md — Go, Jsonnet, and Helm dependency management