Overview
View and manage Kubernetes clusters in your Qovery organization.
Commands
List Clusters
List all clusters in current organization:
Cluster Status
Get detailed cluster status:
qovery cluster status --cluster "cluster-id"
Cluster Info
Get cluster information:
qovery cluster info --cluster "cluster-id"
Download Kubeconfig
Download kubeconfig file for kubectl access:
qovery cluster kubeconfig --cluster-id "cluster-id"
Open Debug Pod
Launch an interactive debug pod with kubectl pre-configured:
qovery cluster debug-pod \
--organization-id "org-id" \
--cluster-id "cluster-id"
Options
| Flag | Description |
|---|
--cluster | Cluster ID or name |
--organization | Organization ID or name |
--output | Output format (table, json, yaml) |
--help | Show help |
Examples
List All Clusters
# Set organization context
qovery context set --organization "My Org"
# List clusters
qovery cluster list
# Example output:
# NAME REGION CLOUD STATUS VERSION
# prod-us-east us-east-1 AWS Running 1.28
# staging-eu eu-west-1 AWS Running 1.27
Check Cluster Status
# Get detailed status
qovery cluster status --cluster "prod-us-east"
# Get JSON output
qovery cluster status \
--cluster "prod-us-east" \
--format json
View Cluster Details
# Get cluster info
qovery cluster info --cluster "prod-us-east"
Get kubectl Access
# Download kubeconfig file
qovery cluster kubeconfig --cluster-id "abc123"
# Set kubectl to use the downloaded config
export KUBECONFIG=./kubeconfig-abc123.yaml
# Test connection
kubectl get nodes
Open Debug Pod for Troubleshooting
# Launch debug pod
qovery cluster debug-pod \
--organization-id "org-abc123" \
--cluster-id "cluster-abc123"
# Inside the debug pod, you can run kubectl commands:
# kubectl get pods --all-namespaces
# kubectl logs <pod-name> -n <namespace>
# exit
Cluster Status Values
| Status | Description |
|---|
RUNNING | Cluster is operational |
DEPLOYING | Cluster is being deployed |
WARNING | Cluster has warnings |
ERROR | Cluster has errors |
DELETING | Cluster is being deleted |
Tips
Use cluster commands to verify cluster health before deploying applications.
Check cluster status regularly to ensure your infrastructure is healthy.
Use qovery cluster kubeconfig to get full kubectl access to your cluster for advanced operations.
The debug-pod command is perfect for quick troubleshooting without needing to configure kubectl locally.
