Skip to content

kindplane cluster

Manage Kind clusters created by kindplane.

Usage

kindplane cluster <subcommand> [flags]

Subcommands

Subcommand Description
list List all kindplane-managed Kind clusters

kindplane cluster list

kindplane cluster list demo

List all Kind clusters on the system.

Usage

kindplane cluster list [flags]

Flags

Flag Description
--all Show all Kind clusters, not just kindplane-managed

Description

Lists Kind clusters on your system. By default, shows clusters managed by kindplane based on naming conventions.

Examples

List kindplane Clusters

kindplane cluster list

List All Kind Clusters

kindplane cluster list --all

Output

╭────────────────────────────────────────────────────────────────╮
│  Kind Clusters                                                  │
├────────────────────────────────────────────────────────────────┤
│  NAME              STATUS    NODES   KUBERNETES                │
│  kindplane-dev     Running   3       v1.29.0                   │
│  kindplane-test    Running   2       v1.28.0                   │
╰────────────────────────────────────────────────────────────────╯

Use Cases

Check Existing Clusters

Before creating a new cluster:

# See what's already running
kindplane cluster list

# Create new cluster
kindplane up

Clean Up Old Clusters

Identify clusters to remove:

# List all clusters
kindplane cluster list --all

# Delete specific cluster
kindplane down --config ./old-project/kindplane.yaml --force

CI/CD Cleanup

Ensure clean state in pipelines:

# Check for existing clusters
kindplane cluster list

# Delete if exists
kindplane down --force || true

# Create fresh cluster
kindplane up
  • up - Create and bootstrap a cluster
  • down - Delete a cluster
  • status - Show cluster status