Skip to main content

astroctl_infra_kubernetes_register

astroctl infra kubernetes register​

Register an existing Kubernetes cluster

Synopsis​

Register any Kubernetes cluster with Astro Platform.

Works with any cluster — EKS, GKE, AKS, on-premises, or local development clusters. The CLI deploys a lightweight agent to your cluster that creates a secure reverse tunnel back to the platform using mTLS. Region is auto-detected when possible.

Cloud provider access for operations like upgrade, scale, and delete can be connected later with: astroctl cloud <provider> connect --cluster <name>

astroctl infra kubernetes register [flags]

Examples​


# Register any cluster (auto-detects type and region)
astroctl infra k8s register --cluster-name my-cluster

# Register only (don't install agent — for split-team flow)
astroctl infra k8s register --cluster-name my-cluster --no-install

# Dry run — print agent manifest without deploying
astroctl infra k8s register --cluster-name my-cluster --dry-run

# Install agent on a pre-registered cluster (split-team flow)
astroctl infra k8s register install --cluster-name my-cluster

# Register from a YAML file
astroctl infra k8s register -f registration.yaml

Options​

  -c, --cluster-name string   Name for the cluster in the platform
      --context string        Kubernetes context to use
      --dry-run               Print agent manifest without deploying
  -f, --file string           YAML file with registration config. Use '-' for stdin.
  -h, --help                  help for register
      --kubeconfig string     Path to kubeconfig file (defaults to current context)
      --labels stringArray    Labels for the cluster (key=value, can be repeated)
      --namespace string      Namespace for agent deployment (default "astroplatform-system")
      --no-install            Register only — don't install agent (for split-team flow)
      --region string         Cloud region override. Auto-detected if omitted.

Options inherited from parent commands​

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

SEE ALSO​