Skillshub k8s-vind

vCluster (vind) Management

install

source · Clone the upstream repo

git clone https://github.com/ComeOnOliver/skillshub

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/rohitg00/kubectl-mcp-server/k8s-vind" ~/.claude/skills/comeonoliver-skillshub-k8s-vind && rm -rf "$T"

manifest: skills/rohitg00/kubectl-mcp-server/k8s-vind/SKILL.md

source content

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

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