How h3xcat/h3xinfra works
H3x Infra is an Ansible-based deployment and operations project for a dual-stack, three-node K3s cluster. An operator configures production inventory and invokes the stack deployment command; Ansible uses that inventory to prepare servers and deploy cluster foundations and services. The resulting cluster provides networking, load balancing, TLS, DNS, gateway routing, storage, email, and identity capabilities. The graph follows the README’s documented stages and capabilities; detailed wiring within unsampled playbooks and charts is not inferred.
Main entry points: stack-standup.yml Stack deployment · h3xinfra-deploy-stack Stack deploy command · 00-prep Server preparation · 01-k3s K3s cluster
Components 19
Deployment
- Production inventory
inventory/production - Stack deploy command
bin/h3xinfra-deploy-stack - Stack deployment
playbooks/stack-standup.yml
Cluster foundation
- Server preparation
playbooks/00-prep - K3s cluster
playbooks/01-k3s
Networking and access
- Cilium networking
playbooks/02-cilium - MetalLB load balancing
playbooks/03-metallb - Certificate management
playbooks/05-certmanager - External DNS
playbooks/06-externaldns - Envoy Gateway
playbooks/07-gateway
Cluster services
- SMB/CIFS driver
playbooks/08-smb - Longhorn storage
playbooks/09-longhorn - Mailu email
playbooks/10-mailu - Keycloak identity
playbooks/10-keycloak
Operations
- Server updates
bin/h3xinfra-update-servers - Cluster utilities
playbooks/99-utils
Other components
- Operator
- Cluster servers
- Cloudflare
Connections 21
- Operator → Stack deploy command: invokes
- Operator → Production inventory: configures
- Stack deploy command → Stack deployment: runs
- Stack deployment → Production inventory: uses
- Stack deployment → Server preparation: deploys
- Stack deployment → K3s cluster: deploys
- Stack deployment → Cilium networking: deploys
- Stack deployment → MetalLB load balancing: deploys
- Stack deployment → Certificate management: deploys
- Stack deployment → External DNS: deploys
- Stack deployment → Envoy Gateway: deploys
- Stack deployment → SMB/CIFS driver: deploys
- Stack deployment → Longhorn storage: deploys
- Stack deployment → Mailu email: deploys
- Stack deployment → Keycloak identity: deploys
- Server preparation → Cluster servers: prepares
- K3s cluster → Cluster servers: installs on
- Certificate management → Cloudflare: uses DNS provider
- External DNS → Cloudflare: updates DNS
- Operator → Server updates: invokes
- Operator → Cluster utilities: invokes