Skip to content

cloudtaser-cli target enroll

Enrolls the current Kubernetes cluster with the CloudTaser SaaS control plane. This validates the enrollment token, discovers cluster metadata, generates a ClusterEnrollment manifest, and registers the cluster with the SaaS platform.

The enrollment token is generated via the SaaS dashboard or SaaS API and contains embedded cluster configuration (secret store endpoint, org ID, tier).

This command: 1. Validates the enrollment token against the SaaS API 2. Discovers cluster metadata (K8s version, node count, cloud provider) 3. Generates a ClusterEnrollment custom resource manifest 4. Registers the cluster with the SaaS control plane

Usage

cloudtaser-cli target enroll [flags]

Examples

# Enroll with a token from the SaaS dashboard
  cloudtaser-cli target enroll \
    --token-file=./enrollment.token \
    --api-url=https://api.cloudtaser.io \
    --cluster-name=prod-eu-west

  # Dry-run to see what would happen
  cloudtaser-cli target enroll \
    --token-file=./enrollment.token \
    --api-url=https://api.cloudtaser.io \
    --cluster-name=staging \
    --dry-run

Flags

Flag Type Default Required Description
--api-url string (empty) yes SaaS control plane API URL (required)
--cluster-name string (empty) yes name for this cluster in the SaaS dashboard (required)
--dry-run bool false no show what would be done without making changes
--help, -h bool false no help for enroll
--timeout duration 20m0s no maximum time for the command to complete (default 20m0s; also CLOUDTASER_TIMEOUT env)
--token string (empty) no enrollment token from the SaaS dashboard (deprecated: visible in /proc/cmdline; prefer --token-file)
--token-file string (empty) no path to file containing enrollment token, or '-' for stdin

All commands