FluxCD — Operations¶

Scope

Multi-tenant GitOps operations, Flux controller management, image automation, and troubleshooting.

Deployment¶

Bootstrap¶

# Bootstrap Flux on a cluster (GitHub)
flux bootstrap github \
  --owner=myorg \
  --repository=fleet-infra \
  --branch=main \
  --path=clusters/production \
  --personal

# Check Flux components
flux check

Multi-Cluster Pattern¶

Pattern	Strategy	Notes
Repo-per-cluster	Separate repos	Simple, isolated
Mono-repo, path-per-cluster	Single repo, path routing	Centralized
Repo-per-team	Team autonomy	Multi-tenant

Image Automation¶

apiVersion: image.toolkit.fluxcd.io/v1beta2
kind: ImagePolicy
metadata:
  name: app-policy
spec:
  imageRepositoryRef:
    name: app
  policy:
    semver:
      range: '>=1.0.0 <2.0.0'

Troubleshooting¶

# Check reconciliation status
flux get all -A
flux get kustomizations
flux get helmreleases

# Force reconciliation
flux reconcile source git flux-system
flux reconcile kustomization apps

# Suspend/resume
flux suspend kustomization apps
flux resume kustomization apps

Issue	Diagnosis	Fix
Source not ready	`flux get sources git`	Check credentials, URL
Kustomization failed	`flux get kustomizations`	Check YAML, dependencies
HelmRelease stuck	`flux get helmreleases`	Check chart version, values
Image not updating	`flux get images all`	Check image policy, scan interval