Edit

opencenter cluster validate

Validate cluster configuration

Synopsis

Validate cluster configuration against schema and business rules.

This command performs comprehensive validation including: • Schema validation against JSON schema • Required field validation • Cross-field dependency validation • GitOps configuration and local repository validation • Network configuration validation • SOPS key validation

Validation mode is selected from global CLI config behavior.validation (default: offline) and can be overridden for one run with --validation. Offline mode does not contact providers, Git remotes, Kubernetes APIs, or external services. Online mode adds provider discovery/connectivity and Git remote checks.

Only v2 configurations (schema_version: "2.0") are supported. Configurations with any other schema version are invalid.

If no cluster name is provided, validates the currently active cluster.

opencenter cluster validate [name] [flags]

Examples

  # Validate active cluster
  opencenter cluster validate

  # Validate specific cluster
  opencenter cluster validate my-cluster

  # Validate with organization/cluster-name format
  opencenter cluster validate my-org/my-cluster

  # Validate with online provider and Git remote checks
  opencenter cluster validate my-cluster --validation online

  # Validate generated GitOps manifests
  opencenter cluster validate my-cluster --manifests

  # Output as JSON (for CI/CD pipelines)
  opencenter cluster validate my-cluster --output json

  # Validate and generate debug config
  opencenter cluster validate my-cluster --generate-debug-config

Options

      --config-file string      path to configuration file to validate
      --generate-debug-config   generate complete config for debugging
  -h, --help                    help for validate
      --manifests               validate generated GitOps manifests
      --output-dir string       directory to save debug config (defaults to current directory)
      --validation string       validation mode for this run: offline or online
  -v, --verbose                 verbose output

SEE ALSO

  • opencenter_cluster.md[opencenter cluster] - Manage cluster configurations

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