Edit

opencenter cluster

Manage cluster configurations

Synopsis

Manage Kubernetes cluster configurations throughout their lifecycle.

The cluster command provides subcommands for initializing, validating, updating, and managing cluster configurations. It supports organization-based multi-tenancy and integrates with GitOps workflows.

Common Workflow:

  1. Create a cluster config opencenter cluster init prod --org acme

  2. Complete provider-specific settings opencenter cluster configure acme/prod

  3. Validate config and prerequisites opencenter cluster validate acme/prod opencenter cluster doctor acme/prod

  4. Generate GitOps assets opencenter cluster generate acme/prod

  5. Deploy the cluster opencenter cluster deploy acme/prod

Configuration files are stored in organization-based directories: ~/.config/opencenter/clusters/<organization>/<cluster>/</cluster></organization>

opencenter cluster [flags]

Examples

  # Create a cluster config
  opencenter cluster init prod --org acme

  # Set active cluster
  opencenter cluster use acme/prod

  # Show active cluster
  opencenter cluster active

  # Generate GitOps assets
  opencenter cluster generate acme/prod

  # Deploy the cluster
  opencenter cluster deploy acme/prod

  # Describe configuration and state
  opencenter cluster describe acme/prod

Options

  -h, --help   help for cluster

SEE ALSO

  • opencenter.md[opencenter] - opencenter CLI manages cluster configurations and GitOps scaffolding

  • opencenter_cluster_active.md[opencenter cluster active] - Show the active cluster

  • opencenter_cluster_backup.md[opencenter cluster backup] - Manage cluster backups

  • opencenter_cluster_configure.md[opencenter cluster configure] - Guided cluster configuration for supported providers

  • opencenter_cluster_deploy.md[opencenter cluster deploy] - Deploy a cluster from its openCenter configuration

  • opencenter_cluster_describe.md[opencenter cluster describe] - Describe cluster configuration, paths, locks, and state

  • opencenter_cluster_destroy.md[opencenter cluster destroy] - Destroy a cluster

  • opencenter_cluster_doctor.md[opencenter cluster doctor] - Check local tools, credentials, and provider readiness

  • opencenter_cluster_drift.md[opencenter cluster drift] - Detect and reconcile infrastructure drift

  • opencenter_cluster_edit.md[opencenter cluster edit] - Edit a cluster configuration in your preferred editor

  • opencenter_cluster_env.md[opencenter cluster env] - Export cluster environment variables

  • opencenter_cluster_export.md[opencenter cluster export] - Export effective cluster configuration

  • opencenter_cluster_generate.md[opencenter cluster generate] - Generate the GitOps repository and rendered manifests

  • opencenter_cluster_import.md[opencenter cluster import] - Import running clusters into openCenter config

  • opencenter_cluster_init.md[opencenter cluster init] - Initialize a new cluster configuration (non-interactive)

  • opencenter_cluster_list.md[opencenter cluster list] - List configured clusters

  • opencenter_cluster_lock.md[opencenter cluster lock] - Lock a cluster to prevent modifications

  • opencenter_cluster_normalize.md[opencenter cluster normalize] - Add missing default fields to a cluster configuration

  • opencenter_cluster_service.md[opencenter cluster service] - Manage cluster services

  • opencenter_cluster_set.md[opencenter cluster set] - Set fields in an existing cluster configuration

  • opencenter_cluster_status.md[opencenter cluster status] - Show cluster status information

  • opencenter_cluster_unlock.md[opencenter cluster unlock] - Unlock a cluster to allow modifications

  • opencenter_cluster_use.md[opencenter cluster use] - Set the active cluster

  • opencenter_cluster_validate.md[opencenter cluster validate] - Validate cluster configuration

Auto generated by spf13/cobra on 28-Apr-2026