How mitchross/talos-argocd-proxmox works
This repository defines a Talos-on-Proxmox homelab Kubernetes cluster and its GitOps-managed services. The principal workflow is administrator-driven node provisioning through Omni, followed by one-time cluster bootstrap and Argo CD reconciliation of platform dependencies and discovered applications. Separate branches cover storage and zero-touch backups, ingress/networking, GPU workloads, and monitoring. Edges reflect README-described orchestration and configuration relationships; sampled source files are peripheral to the main cluster workflow, so implementation-level wiring not documented there is omitted.
Main entry points: core-dependencies Core Dependencies · root.yaml Argo CD Root · appsets ApplicationSets · kopiur-operator Kopiur Operator
Components 19
Cluster Provisioning
- Omni
omni/omni - Proxmox Provider
omni/proxmox-providers - Talos Cluster
omni/cluster-template
GitOps Reconciliation
- Git Repository
- Argo CD Root
infrastructure/controllers/argocd/root.yaml - ApplicationSets
infrastructure/controllers/argocd/apps/appsets
Cluster Platform
- Core Dependencies
infrastructure/controllers/argocd/apps/core-dependencies - Cilium Networking
infrastructure/networking/cilium - Gateway API
infrastructure/networking/gateway - GPU Support
infrastructure/controllers/nvidia-gpu-operator
Storage & Backups
- Longhorn Storage
infrastructure/storage/longhorn - Kopiur Operator
infrastructure/controllers/kopiur-operator - Backup Configuration
infrastructure/controllers/kopiur - RustFS Storage
infrastructure/storage/rustfs-lifecycle
Workloads & Observability
- User Applications
my-apps - Monitoring Stack
monitoring/prometheus-stack - OpenTelemetry
infrastructure/controllers/opentelemetry-operator
Other components
- Administrator
- NAS Storage
Connections 21
- Administrator → Omni: provisions with
- Omni → Proxmox Provider: uses provider
- Omni → Talos Cluster: provisions
- Administrator → Argo CD Root: bootstraps
- Git Repository → Argo CD Root: provides configuration
- Argo CD Root → ApplicationSets: creates
- Argo CD Root → Core Dependencies: orders sync
- ApplicationSets → User Applications: discovers applications
- ApplicationSets → Monitoring Stack: discovers applications
- ApplicationSets → GPU Support: discovers applications
- Core Dependencies → Cilium Networking: deploys
- Core Dependencies → Longhorn Storage: deploys
- Core Dependencies → Kopiur Operator: deploys
- Core Dependencies → Gateway API: deploys
- Backup Configuration → Kopiur Operator: configures
- Backup Configuration → RustFS Storage: targets repository
- Kopiur Operator → Longhorn Storage: restores volumes
- Kopiur Operator → NAS Storage: backs up to
- Argo CD Root → OpenTelemetry: reconciles
- OpenTelemetry → Monitoring Stack: exports telemetry
- User Applications → GPU Support: uses GPU support