Skip to main content

astroctl infra kubernetes rollback

Rollback cluster to a previous Kubernetes version

Synopsis​

Roll back a cluster to a previous Kubernetes version.

⚠️ IMPORTANT - BEHAVIOR VARIES BY PROVISIONER:

GKE:

  • CONTROL PLANE: Cannot be rolled back (stays at current version)
  • NODE POOLS: Will be downgraded to the target version
  • VERSION SKEW: Max 2 minor versions behind control plane

EKS:

  • CONTROL PLANE: Cannot be rolled back (stays at current version)
  • NODE GROUPS: Replaced using blue-green deployment with target version
  • Note: This creates NEW node groups, not in-place downgrade

Self-Hosted:

  • CONTROL PLANE: CAN be rolled back (full downgrade supported)
  • NODE GROUPS: Will be rolled back via rolling update

This command validates the rollback path and warns about limitations.

astroctl infra kubernetes rollback <cluster-name> [target-version] [flags]

Examples​

# List available versions for rollback
astroctl infra k8s rollback my-cluster --list-versions

# Rollback node pools to version 1.29
astroctl infra k8s rollback my-cluster 1.29

# Preview rollback without applying
astroctl infra k8s rollback my-cluster 1.29 --dry-run

# Skip confirmation
astroctl infra k8s rollback my-cluster 1.29 --yes

Options​

      --dry-run         Preview rollback without applying changes
      --force           Skip all validations and confirmations (for automation)
  -h, --help            help for rollback
      --list-versions   List available Kubernetes versions for rollback
      --yes             Skip confirmation prompt (requires typing cluster name)

Options inherited from parent commands​

  -o, --output string   Output format (json|yaml) (default "yaml")

SEE ALSO​