homelab/manifests
Nik Afiq d410c05e6d
Some checks failed
validate / lint (push) Failing after 0s
fix: correct Multus binDir/cnibin path for k3s delegate plugin exec
Root cause: Multus's ChrootExec resolves a delegate plugin's absolute
path from the daemon container's own filesystem view, then execs that
exact path string after chrooting into the real host root. binDir
defaulted to /opt/cni/bin, which is valid inside the container (bind-
mounted to k3s's real bin dir) but doesn't exist on the actual host, so
every pod attaching to the VLAN 50 NAD failed FailedCreatePodSandBox
trying to delegate to flannel. Confirmed against multus-cni's source at
the exact pinned v4.3.0 tag, not assumed. Sets binDir explicitly to
k3s's real path and matches the cnibin mount path to it on both sides of
the chroot boundary (main container and the install_multus init
container).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-24 20:06:04 +09:00
..
2026-05-06 01:44:28 +09:00

Kubernetes Manifests

This directory contains raw Kubernetes resources grouped by service area. Most subdirectories are consumed by Argo CD Applications in argocd/apps.

Directories

Directory Contents
argocd/ App-of-apps, Argo CD ingress, Argo CD OIDC sealed secret
authentik/ Authentik ingress, public ingress, proxy outpost, middleware, secret scripts
cert-manager/ Internal and Let's Encrypt ClusterIssuers, Porkbun secret script
core/ Dashy, Glances, CoreDNS custom config, CA installer
gitea/ Gitea storage, backup, public ingress, runner and OIDC/admin secrets
home-services/ HA gateway, AI gateway, Discord bot, service TLS, registry secret
homeassistant/ Home Assistant external service and ingress
media/ Jellyfin, qBittorrent, JDownloader (sending links)
monitoring/ Monitoring PVs, Grafana datasource, Grafana/Auth OIDC secrets
network/ Pi-hole secrets, DDNS, Traefik dashboard, external host ingresses
portfolio/ Portfolio deployment, ingress, registry pull secret

Secrets

There are two patterns:

  • *-sealed.yaml files are safe to commit and are reconciled by Sealed Secrets.
  • *.sh scripts create runtime Secrets from .env directly in the cluster.

Use .env.example as the template for local secret names. kubeseal must point at the in-cluster controller named sealed-secrets-controller in kube-system.

Regenerate committed sealed secrets with the matching script, then commit the resulting YAML. Runtime secret scripts should be run against the target cluster and should not produce committed plaintext.

Certificates

Internal services generally use internal-ca-issuer and home.arpa hostnames. Public services use Let's Encrypt issuers and nik4nao.com hostnames.

The CA installer lives in core/ca-installer. Its ca-sync CronJob keeps the served ca.crt and Apple mobileconfig in sync with the cert-manager CA secret.

DNS

Internal DNS records are configured in values/pihole.yaml and values/pihole-debian.yaml. Add a new hostname to both files when adding a home.arpa service.

Dashy

core/dashy.yaml defines the deployment and a placeholder ConfigMap. The real dashboard config comes from config/dashy/conf.yaml:

bash manifests/core/apply-dashy-config.sh