ReddRadar
Agent skill
k8s-vind
Manage vCluster (virtual Kubernetes clusters) instances using vind. Use when creating, managing, or operating lightweight virtual clusters for development, testing, or multi-tenancy.
Install this agent skill to your Project
npx add-skill https://github.com/rohitg00/kubectl-mcp-server/tree/main/kubernetes-skills/claude/k8s-vind
Metadata
Additional technical details for this skill
- tools
- 14
- author
- rohitg00
- version
- 1.0.0
- category
- development
SKILL.md
vCluster (vind) Management
Manage virtual Kubernetes clusters using kubectl-mcp-server's vind tools (14 tools).
vCluster enables running fully functional Kubernetes clusters as lightweight workloads inside a host cluster, combining multi-tenancy with strong isolation.
When to Apply
Use this skill when:
- User mentions: "vCluster", "vind", "virtual cluster", "lightweight cluster"
- Operations: creating dev environments, multi-tenant isolation, ephemeral clusters
- Keywords: "virtual Kubernetes", "dev cluster", "pause cluster", "tenant isolation"
Priority Rules
| Priority | Rule | Impact | Tools |
|---|---|---|---|
| 1 | Detect vCluster CLI first | CRITICAL | vind_detect_tool |
| 2 | Check cluster status before operations | HIGH | vind_status_tool |
| 3 | Connect before kubectl operations | HIGH | vind_connect_tool |
| 4 | Pause unused clusters to save resources | MEDIUM | vind_pause_tool |
Quick Reference
| Task | Tool | Example |
|---|---|---|
| Detect vCluster | vind_detect_tool |
vind_detect_tool() |
| List clusters | vind_list_clusters_tool |
vind_list_clusters_tool() |
| Create cluster | vind_create_cluster_tool |
vind_create_cluster_tool(name) |
| Connect to cluster | vind_connect_tool |
vind_connect_tool(name) |
Prerequisites
- vCluster CLI: Required for all vind tools
bash
curl -L -o vcluster "https://github.com/loft-sh/vcluster/releases/latest/download/vcluster-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" chmod +x vcluster && sudo mv vcluster /usr/local/bin/
Check Installation
vind_detect_tool()
List Clusters
vind_list_clusters_tool()
Get Cluster Status
vind_status_tool(name="my-vcluster", namespace="vcluster")
Get Kubeconfig
vind_get_kubeconfig_tool(name="my-vcluster", namespace="vcluster")
View Logs
vind_logs_tool(name="my-vcluster", namespace="vcluster", tail=100)
Cluster Lifecycle
Create Cluster
vind_create_cluster_tool(name="dev-cluster")
vind_create_cluster_tool(
name="dev-cluster",
namespace="dev",
kubernetes_version="v1.29.0",
connect=True
)
vind_create_cluster_tool(
name="custom-cluster",
set_values="sync.toHost.pods.enabled=true,sync.toHost.services.enabled=true"
)
Delete Cluster
vind_delete_cluster_tool(name="dev-cluster")
vind_delete_cluster_tool(
name="dev-cluster",
namespace="dev",
delete_namespace=True
)
Pause Cluster (Save Resources)
vind_pause_tool(name="dev-cluster")
Resume Cluster
vind_resume_tool(name="dev-cluster")
Connect/Disconnect
Connect to Cluster
vind_connect_tool(name="dev-cluster")
vind_connect_tool(
name="dev-cluster",
namespace="dev",
kube_config="~/.kube/vcluster-config"
)
Disconnect from Cluster
vind_disconnect_tool()
Upgrade Cluster
vind_upgrade_tool(
name="dev-cluster",
kubernetes_version="v1.30.0"
)
vind_upgrade_tool(
name="dev-cluster",
values_file="new-values.yaml"
)
Describe Cluster
vind_describe_tool(name="dev-cluster")
Platform UI
vind_platform_start_tool()
vind_platform_start_tool(host="0.0.0.0", port=9898)
Development Workflow
Quick Dev Environment
vind_create_cluster_tool(name="dev", connect=True)
kubectl_apply(manifest="""
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: my-app
template:
metadata:
labels:
app: my-app
spec:
containers:
- name: app
image: nginx:alpine
""")
Multi-Tenant Setup
vind_create_cluster_tool(name="team-a", namespace="team-a-vcluster")
vind_create_cluster_tool(name="team-b", namespace="team-b-vcluster")
vind_list_clusters_tool()
Resource Management
vind_pause_tool(name="dev")
vind_resume_tool(name="dev")
Docker-Specific Configuration
For vCluster in Docker (vind) deployments, use --set values:
vind_create_cluster_tool(
name="docker-cluster",
set_values="experimental.docker.network=my-network,experimental.docker.ports[0].containerPort=80"
)
Troubleshooting
Cluster Not Starting
1. vind_detect_tool()
2. vind_logs_tool(name="my-cluster", tail=200)
3. vind_status_tool(name="my-cluster")
Connection Issues
1. vind_disconnect_tool()
2. vind_connect_tool(name="my-cluster")
3. vind_get_kubeconfig_tool(name="my-cluster")
Resource Issues
1. vind_pause_tool(name="unused-cluster")
2. vind_delete_cluster_tool(name="old-cluster", delete_namespace=True)
CLI Installation
Install vCluster CLI:
curl -L -o vcluster "https://github.com/loft-sh/vcluster/releases/latest/download/vcluster-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"
chmod +x vcluster
sudo mv vcluster /usr/local/bin/
vcluster version
Related Skills
- k8s-multicluster - Multi-cluster management
- k8s-helm - Helm chart operations
- k8s-operations - kubectl operations
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rohitg00/kubectl-mcp-server
k8s-multicluster
Manage multiple Kubernetes clusters, switch contexts, and perform cross-cluster operations. Use when working with multiple clusters, comparing environments, or managing cluster lifecycle.
rohitg00/kubectl-mcp-server
k8s-incident
Respond to Kubernetes incidents with runbooks and diagnostics. Use for outages, pod failures, node issues, network problems, and emergency response.
rohitg00/kubectl-mcp-server
k8s-gitops
Manage GitOps workflows with Flux and ArgoCD. Use for sync status, reconciliation, app management, source management, and GitOps troubleshooting.
rohitg00/kubectl-mcp-server
k8s-autoscaling
Configure Kubernetes autoscaling with HPA, VPA, and KEDA. Use for horizontal/vertical pod autoscaling, event-driven scaling, and capacity management.
rohitg00/kubectl-mcp-server
k8s-deploy
Deploy and manage Kubernetes workloads with progressive delivery. Use for deployments, rollouts, blue-green, canary releases, scaling, and release management.
rohitg00/kubectl-mcp-server
k8s-cost
Optimize Kubernetes costs through resource right-sizing, unused resource detection, and cluster efficiency analysis. Use for cost optimization, resource analysis, and capacity planning.
Didn't find tool you were looking for?