Usage

Worked examples, smallest first. Each page covers one feature with a complete, copy-pasteable StageSet; the API reference has the exhaustive field-by-field detail. See the CLI for stagesetctl commands.

• Actions

  Typed pre, post, and on-failure steps — jobs, HTTP gates, waits, patches, deletes, transient applies.

• Conflict policies

  Resolve immutable-field and ownership conflicts per resource.

• Multi-cluster and tenancy

  Impersonation, watch scoping, single-tenant cluster-admin, and remote clusters.

• Producer-aware sources

  Reference a producer like JaaS and let the controller find its ExternalArtifact.

• Ready checks

  Gate a stage on health with kstatus and CEL expressions.

• Rollback

  Restore the last good artifact revision when a run fails.

• Secrets encryption (SOPS)

  Decrypt SOPS-encrypted files in a stage's source before they are applied.

• Stages and sources

  The core — ordered stages applying Flux sources, with path, prune, patches, and substitution.

• Update windows

  Allow or deny rollouts on a schedule, without pausing reconciliation.

• Versioned migrations

  Run migrations once, when the deployed version crosses a release boundary.