FluxCD

Overview

KC02 uses FluxCD to power automated deployment and reconciliation of manifests in the publicly available GitHub repository. FluxCD watches the Git repository that defines the cluster state and ensures that the actual cluster matches the desired configuration declared in code.

Manual Sync and Reconciliation

flux reconcile kustomization apps

Initial Setup

# install flux
curl -s https://fluxcd.io/install.sh | sudo bash
 
# Create github access token with repo permissions
export GITHUB_TOKEN=<your-token>
export GITHUB_USER=simonyjung
 
# check flux installation
flux check --pre
 
# bootstrap flux on the cluster
flux bootstrap github \
  --owner=simonyjung \
  --repository=homelab \
  --branch=main \
  --path=./clusters/staging \
  --personal
  

Repository Structure

homelab-infra/
├── clusters/
│   └── staging/
│       ├── flux-system/
└── ...

flux-system/: Contains the manifests for bootstrapping.

Troubleshooting

• CrashLoopBackOff on source-controller: May indicate missing or misconfigured CRDs. Follow initial setup instructions to bootstrap flux.