About this project

kluster is a declarative home infrastructure project that uses Pulumi Python to manage a Talos Linux Kubernetes cluster. The deployment spans an OCI VCN and a local homelab LAN, utilizing Cilium for networking. Key components of the repository include: - Infrastructure Management: Uses Pulumi to declare resources, including a custom state-backend appliance (Fedora CoreOS) and DNS configurations via Cloudflare. - Tooling: Managed with uv and mise, featuring custom console scripts for credential management and state-backend operations. - Architecture: Includes a framework layer for Pulumi components, custom provider implementations for systems without native Pulumi providers, and a dedicated directory for self-built container images. - Documentation: Extensive design documentation covering cluster architecture, physical machine designs, declarative layers, and operational runbooks. - Security: Implements a specific credential model using Age ciphertexts for secrets and mutual TLS for the state backend.