Troubleshooting Cluster Issues
This guide covers common cluster-related problems and provides step-by-step solutions to resolve them.
Cluster Access Issues
Cannot Download Kubeconfig
Symptoms
- Kubeconfig download button is disabled
- Download fails with error message
- Button appears grayed out
Diagnostic Steps
- Check Cluster Status: Verify cluster is in "Active" state
- Verify Permissions: Ensure appropriate access rights are available
- Browser Check: Try a different browser or disable ad blockers
- Network Connectivity: Verify stable internet connection
Solutions
Cluster Not Active
Issue: Cluster status shows "Suspended" or "Terminated"
Solution: Only active clusters allow kubeconfig download
Action: Wait for cluster to return to active state or contact support
Permission Issues
Issue: Insufficient permissions to access cluster credentials
Solution: Contact administrator for proper access rights
Action: Request cluster access through your organization's process
kubectl Commands Failing
Symptoms
- "Unable to connect to server" errors
- Authentication failures
- Timeout errors when using kubectl
Diagnostic Commands
# Test basic connectivity
kubectl cluster-info
# Check configuration
kubectl config view
# Verify current context
kubectl config current-context
# List available contexts
kubectl config get-contexts
Solutions
Connection Timeouts
- Check Network: Verify internet connectivity
- Firewall Rules: Ensure port 6443 is accessible
- VPN Issues: Try connecting without VPN
- DNS Resolution: Verify cluster endpoint resolves correctly
Authentication Errors
- Re-download Kubeconfig: Get fresh credentials from cluster overview
- Check File Path: Verify kubeconfig file path is correct
- File Permissions: Ensure kubeconfig file has proper permissions
- Context Selection: Switch to correct kubectl context
Certificate Errors
# Check certificate validity
openssl x509 -in /path/to/cert -text -noout
# Update kubeconfig with new certificates
# Re-download from cluster overview page