Cluster Management

This guide covers how to manage Openshift and Kubernetes clusters in SNAP.

Adding a New Cluster

Prerequisites

Step-by-Step Process

  1. Navigate to Configuration
    • Go to Configuration > Clusters
    • Click Add New Cluster
  2. Basic Configuration 
    Cluster Name: production-cluster
API Server URL: https://api.cluster.com:6443
Authentication Type: kubeconfig
  3. Authentication Setup
    • Kubeconfig: Upload your kubeconfig file
    • Token: Enter authentication token
    • Service Account: Use existing service account
  4. Registry Selection
    • Select configured registry for image storage
    • This enables checkpoint-to-image conversion
  5. Advanced Settings
    • Namespace: Default namespace for operations
    • SSL Verification: Enable/disable SSL verification
    • Timeout: API request timeout settings

⚠️ Deprecated Operations

The following cluster operations have been deprecated and are now handled automatically by the DaemonSet:

❌ Enable Checkpointing (Deprecated)

# DEPRECATED: This endpoint is no longer available
curl -X POST http://localhost:8000/cluster/enable_checkpointing \
  -H "Content-Type: application/json" \
  -d '{
    "cluster_name": "production-cluster",
    "node_names": ["worker-node-1", "worker-node-2"]
  }'
# Returns: {"success": false, "message": "This endpoint is deprecated. Checkpointing is now handled automatically by the DaemonSet."}

❌ Install runC (Deprecated)

# DEPRECATED: This endpoint is no longer available
curl -X POST http://localhost:8000/cluster/install_runc \
  -H "Content-Type: application/json" \
  -d '{
    "cluster_name": "production-cluster",
    "runc_version": "1.2.4"
  }'
# Returns: {"success": false, "message": "This endpoint is deprecated. runc installation is now handled automatically by the DaemonSet."}

❌ Verify Checkpointing (Deprecated)

# DEPRECATED: This endpoint is no longer available
curl -X POST http://localhost:8000/cluster/verify_checkpointing \
  -H "Content-Type: application/json" \
  -d '{"cluster_name": "production-cluster"}'
# Returns: {"success": false, "message": "This endpoint is deprecated. Cluster verification is now handled automatically by the DaemonSet."}

✅ Current Operations

Deploy Cluster Monitor DaemonSet

# Deploy the cluster monitoring DaemonSet to your cluster
kubectl apply -f SnapApi/snap-cluster-monitor-daemonset.yaml

Check Cluster Status (via DaemonSet)

# Check cluster status from DaemonSet
curl -X GET http://localhost:8000/cluster/status/production-cluster \
  -H "Authorization: Bearer YOUR_TOKEN"

Cluster Monitoring

Deploy Cluster Monitor DaemonSet

kubectl apply -f SnapApi/snap-cluster-monitor-daemonset.yaml

Check Cluster Status

Troubleshooting Cluster Issues

Common Problems

Diagnostic Commands

# Check cluster connectivity
kubectl cluster-info

# Verify node status
kubectl get nodes -o wide

# Check DaemonSet status
kubectl get daemonset -n snap

# View cluster events
kubectl get events --all-namespaces

Add Cluster Interface Guide

For detailed step-by-step instructions on using the “Add Cluster” form, see our comprehensive Add Cluster Configuration Guide.

Quick Reference

Form Validation

The form validates: