Skip to main content
Alison Aquinas logoAlison's LLM Skills Marketplace

flux

Included in skill bundleci-cdView on GitHub ↗

Files

SKILL.mdagentsreferences

Install

Install only this skill with npx skills
npx skills add alisonaquinas/llm-ci-dev --skill 'flux' -g -y
Install the containing skill bundle
/plugin install ci-cd@llm-skills
Download flux-skill.zip
This skill is bundled inside ci-cd. Use npx skills when you only want this skill, or install the bundle once to make every included skill available through the plugin marketplace flow. Browse the full skill bundle repository at github.com/alisonaquinas/llm-ci-dev.

Invoke

Invoke this skill after installation
/ci-cd:flux

SKILL.md

name: flux description: Manage GitOps Kubernetes deployments with FluxCD sources and Kustomizations. Use when tasks mention flux, FluxCD, flux bootstrap, GitRepository CRD, HelmRelease CRD, Kustomization CRD, or GitOps with Flux.

flux

Use this skill to keep FluxCD GitOps deployments safe, auditable, and reconciled correctly across environments.

Intent Router

RequestReferenceLoad When
Install flux CLI, bootstrap GitHub/GitLab, verifyreferences/install-and-setup.mdUser needs to install flux or bootstrap a cluster
get/reconcile/suspend/resume/diff/logs commandsreferences/command-cookbook.mdUser needs to run flux CLI commands
GitRepository, HelmRepository, OCIRepository, ImagePolicyreferences/gitops-sources.mdUser needs to configure GitOps source CRDs
Kustomization and HelmRelease CRD fieldsreferences/kustomizations-and-helmreleases.mdUser needs to configure workload reconciliation

Quick Start

# Check prerequisites before bootstrap
flux check --pre

# Bootstrap with GitHub
flux bootstrap github \
  --owner=my-org \
  --repository=my-fleet-repo \
  --path=clusters/my-cluster \
  --personal

# Verify all Flux controllers are healthy
flux check

# Show all managed resources
flux get all

Core Command Tracks

  • Status: flux get all — overview of all sources and workloads
  • Reconcile: flux reconcile source git <name> — force sync from git
  • Diff: flux diff kustomization <name> — preview changes before committing
  • Suspend/resume: flux suspend/resume kustomization <name> — pause reconciliation
  • Logs: flux logs — stream Flux controller logs
  • Events: flux events — show recent Kubernetes events from Flux objects

Safety Guardrails

  • Run flux check after bootstrap and after any change to the flux-system namespace to verify controller health.
  • Use flux diff kustomization <name> to preview changes before committing to the GitOps source repo.
  • Use flux suspend kustomization <name> before making emergency manual changes to avoid immediate reconciliation reverting them.
  • Never delete flux-system namespace resources directly — use flux uninstall for clean removal.
  • Set prune: true on Kustomizations only after verifying the resource list is complete; missing resources will be deleted.
  • Store bootstrap secrets (GitHub PAT, deploy keys) as Kubernetes secrets or use SOPS/sealed-secrets — never in plaintext in git.
  • Use dependsOn to ensure infrastructure (CRDs, namespaces) is ready before dependent workloads reconcile.

Workflow

  1. Run flux check --pre to verify prerequisites before bootstrap.
  2. Run flux bootstrap github/gitlab to install Flux and commit generated manifests to git.
  3. Define sources (GitRepository, HelmRepository) and workloads (Kustomization, HelmRelease) as YAML in the fleet repo.
  4. Use flux diff kustomization <name> to preview the effect of changes before pushing to git.
  5. Monitor reconciliation with flux get all and flux events.
  6. On failure, use flux logs and kubectl describe on the failing CRD object to diagnose.
# Troubleshoot a stuck reconciliation: suspend, inspect, then resume
flux suspend kustomization my-app
kubectl describe kustomization my-app -n flux-system
flux resume kustomization my-app
flux get kustomization my-app

Related Skills

  • kubectl — inspect Kubernetes resources managed by Flux
  • kustomize — Kustomize overlays reconciled by Flux Kustomization CRD
  • helm — Helm releases managed by Flux HelmRelease CRD
  • ci-architecture — CI pipeline patterns that feed the GitOps source repo
  • github-cd — GitHub Actions workflows that push to the Flux fleet repo
  • gitlab-cd — GitLab CI pipelines that push to the Flux fleet repo

References

← Back to marketplace