Migrations

• AwaitingApproval

  A version transition is held for approval; approve the target version to proceed.

• DowngradeNotAllowed

  The desired version is below the deployed version and downgrades are not enabled.

• DowngradeRequiresMigration

  A downgrade is enabled, but a version boundary it crosses declares no down actions and is irreversible.

• Generating migrations with Jsonnet

  Render a version-gated migration ladder with JaaS and consume it from a StageSet via migrationsSourceRef.

• MigrationArtifactInvalid

  A migration ladder sourced via spec.migrationsSourceRef could not be parsed or failed content validation; the version is held back until the artifact is fixed.

• MigrationCoverageMissing

  A major-version transition has no migration covering it, and requireMigrationCoverage is set; the version is held back.

• MigrationDirty

  A migration failed repeatedly, so the controller halted auto-retry; clear the halt with a manual reconcile once the cause is fixed.

• MigrationFailed

  A migration's action failed; the run halts at that stage and retries with backoff, skipping already-completed actions.

• MigrationSourceNotPinned

  A sourced migration ladder's source is pinned to a mutable tag/branch instead of an immutable digest/commit, and pinning is required.

• MigrationSourceNotVerified

  A sourced migration ladder's source is not signature-verified; the destructive ladder is refused until verification passes.

• MigrationStageNotFound

  A version-selected migration anchors to a stage that doesn't exist in this StageSet; the version is held back rather than skipping the migration.

• stagesetctl lint-migrations

  Validate a migration ladder file or directory before publishing it to a source.

• Versioned migrations

  Run migrations once, when the deployed version crosses a release boundary — inline, or sourced from a Flux artifact and shared across StageSets.