Skip to main content

astroctl_infra_kubernetes_unregister

astroctl infra kubernetes unregister​

Unregister a cluster from the platform

Synopsis​

Completely remove a registered cluster from Astro Platform.

What this does:

  • DELETES all platform-managed applications and their resources from your cluster
  • Disconnects the agent tunnel
  • Deletes the cluster record from the platform
  • Removes the agent from the target cluster (if kubeconfig is provided)

What this does NOT do:

  • Does NOT delete or modify the cluster itself (EKS, GKE, etc.)
  • Resources NOT managed by the platform are untouched

Only works for clusters registered via 'astroctl infra k8s register'. For provisioned clusters, use 'astroctl infra k8s delete' instead.

astroctl infra kubernetes unregister [flags]

Examples​


# Unregister a cluster (also removes agent if kubeconfig is available)
astroctl infra k8s unregister --cluster-name my-cluster

# Unregister with explicit kubeconfig context
astroctl infra k8s unregister --cluster-name my-cluster --context my-context

# Unregister without removing the agent from the cluster
astroctl infra k8s unregister --cluster-name my-cluster --skip-agent

Options​

  -c, --cluster-name string   Name of the cluster to unregister
      --context string        Kubeconfig context to use
  -h, --help                  help for unregister
      --kubeconfig string     Path to kubeconfig file (defaults to ~/.kube/config)
      --skip-agent            Skip removing the agent from the target cluster

Options inherited from parent commands​

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

SEE ALSO​