VMware VKS

Autor: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com Dies ist ein von der Community getriebenes Projekt eines VMware-Ingenieurs, kein offizielles VMware-Produkt. Offizielle VMware-Entwicklertools finden Sie unter developer.broadcom.com.

Englisch | Chinesisch

MCP-Skill + CLI für die Verwaltung von VMware vSphere Kubernetes Service (VKS) — Supervisor-Cluster, vSphere-Namespaces und VKS-Cluster-Lebenszyklus. 20 MCP-Tools.

👁 Lizenz: MIT

Begleitende Skills

Teil der VMware MCP-Skill-Familie. Jeder Skill deckt einen eigenen Bereich ab — installieren Sie nur, was Sie benötigen.

Related MCP server: vmware-nsx

Voraussetzungen

• vSphere 8.0+ — Workload Management (Supervisor) APIs erfordern vSphere 8.x

• Workload Management aktiviert — WCP muss auf mindestens einem Compute-Cluster aktiviert sein

• Lizenz — vSphere Kubernetes Service (Enterprise Plus oder VMware Cloud Foundation)

Führen Sie nach der Einrichtung vmware-vks check aus, um zu überprüfen, ob alle Anforderungen erfüllt sind.

Schnellstart

# Install
uv tool install vmware-vks

# Configure
mkdir -p ~/.vmware-vks
cp config.example.yaml ~/.vmware-vks/config.yaml
# Edit config.yaml with your vCenter host and username

echo "VMWARE_MY_VCENTER_PASSWORD=your_password" > ~/.vmware-vks/.env
chmod 600 ~/.vmware-vks/.env

# Verify
vmware-vks check

# Common operations
vmware-vks supervisor status domain-c1
vmware-vks namespace list
vmware-vks tkc list
vmware-vks tkc create my-cluster -n dev --version v1.28.4+vmware.1 --vm-class best-effort-large
vmware-vks tkc create my-cluster -n dev --apply

Häufige Arbeitsabläufe

Bereitstellung eines neuen TKC-Clusters

1. Kompatibilität prüfen → vmware-vks check

2. Verfügbare K8s-Versionen auflisten → vmware-vks tkc versions -n dev

3. Namespace erstellen (falls erforderlich) → vmware-vks namespace create dev --cluster domain-c1 --storage-policy vSAN --cpu 16000 --memory 32768 --apply

4. TKC-Cluster erstellen → vmware-vks tkc create dev-cluster -n dev --version v1.28.4+vmware.1 --control-plane 1 --workers 3 --vm-class best-effort-large --apply

5. Kubeconfig abrufen → vmware-vks kubeconfig get dev-cluster -n dev

Worker für Lasttests skalieren

1. Aktuellen Status prüfen → vmware-vks tkc get dev-cluster -n dev

2. Hochskalieren → vmware-vks tkc scale dev-cluster -n dev --workers 6

3. Fortschritt überwachen → vmware-vks tkc get dev-cluster -n dev (Phase beobachten)

4. Nach dem Test wieder herunterskalieren

Namespace-Ressourcenverwaltung

1. Namespaces auflisten → vmware-vks namespace list

2. Auslastung prüfen → vmware-vks storage -n dev

3. Kontingent aktualisieren → vmware-vks namespace update dev --cpu 32000 --memory 65536

Tool-Referenz (20 Tools)

Supervisor

Namespace

TKC

Zugriff

Architektur

User (Natural Language)
 ↓
AI Agent (Claude Code / Goose / Cursor)
 ↓ reads SKILL.md
 ↓
vmware-vks CLI ─── or ─── vmware-vks MCP Server (stdio)
 │
 ├─ Layer 1: pyVmomi → vCenter REST API
 │ Supervisor status, storage policies, Namespace CRUD, VM classes, Harbor
 │
 └─ Layer 2: kubernetes client → Supervisor K8s API endpoint
 TKC CR apply / get / delete (cluster.x-k8s.io/v1beta1)
 Kubeconfig built from Layer 1 session token
 ↓
vCenter Server 8.x+ (Workload Management enabled)
 ↓
Supervisor Cluster → vSphere Namespaces → TanzuKubernetesCluster

CLI-Referenz

# Pre-flight diagnostics
vmware-vks check

# Supervisor
vmware-vks supervisor status <cluster-id>
vmware-vks supervisor storage-policies

# Namespace
vmware-vks namespace list
vmware-vks namespace get <name>
vmware-vks namespace create <name> --cluster <id> --storage-policy <policy>
vmware-vks namespace create <name> --cluster <id> --storage-policy <policy> --apply
vmware-vks namespace update <name> [--cpu <mhz>] [--memory <mib>]
vmware-vks namespace delete <name>
vmware-vks namespace vm-classes

# VKS Cluster
vmware-vks tkc list [-n <namespace>]
vmware-vks tkc get <name> -n <namespace>
vmware-vks tkc versions -n <namespace>
vmware-vks tkc create <name> -n <namespace> [--version <v>] [--vm-class <c>]
vmware-vks tkc create <name> -n <namespace> --apply
vmware-vks tkc scale <name> -n <namespace> --workers <n>
vmware-vks tkc upgrade <name> -n <namespace> --version <v>
vmware-vks tkc delete <name> -n <namespace>

# Kubeconfig
vmware-vks kubeconfig supervisor -n <namespace>
vmware-vks kubeconfig get <cluster-name> -n <namespace> [-o <path>]

# Harbor & Storage
vmware-vks harbor
vmware-vks storage -n <namespace>

MCP-Server

Nach uv tool install vmware-vks starten Sie den MCP-Server mit einem Befehl (v1.5.15+):

# Recommended — single command, no network re-resolve
vmware-vks mcp

# With a custom config path
VMWARE_VKS_CONFIG=/path/to/config.yaml vmware-vks mcp

Agentenkonfiguration

Fügen Sie dies zur MCP-Konfiguration Ihres KI-Agenten hinzu:

{
 "mcpServers": {
 "vmware-vks": {
 "command": "vmware-vks",
 "args": ["mcp"],
 "env": {
 "VMWARE_VKS_CONFIG": "~/.vmware-vks/config.yaml"
 }
 }
 }
}

# Run without installing (requires PyPI access each launch)
uvx --from vmware-vks vmware-vks mcp

# Legacy entry point (still works, kept for backward compatibility)
vmware-vks-mcp

Hinter einem Unternehmens-TLS-Proxy? uvx schlägt möglicherweise mit invalid peer certificate: UnknownIssuer fehl. Verwenden Sie die empfohlene vmware-vks mcp-Form von oben (kein Netzwerk erforderlich) oder setzen Sie UV_NATIVE_TLS=true.

Sicherheit

Fehlerbehebung

Fehler "VKS not compatible"

Workload Management muss in vCenter aktiviert sein. Überprüfen Sie: vCenter UI -> Workload Management. Erfordert vSphere 8.x+ mit Enterprise Plus- oder VCF-Lizenz.

Namespace-Erstellung schlägt mit "storage policy not found" fehl

Listen Sie zuerst die verfügbaren Richtlinien auf: vmware-vks supervisor storage-policies. Richtliniennamen unterscheiden zwischen Groß- und Kleinschreibung.

TKC-Cluster bleibt in der Phase "Creating" hängen

Überprüfen Sie die Supervisor-Ereignisse in vCenter. Häufige Ursachen: unzureichende Ressourcen auf ESXi-Hosts, Netzwerkprobleme mit NSX-T oder die Speicherrichtlinie ist auf dem Zieldatastore nicht verfügbar.

Abruf der Kubeconfig schlägt fehl

Der Supervisor-API-Endpunkt muss von dem Computer aus erreichbar sein, auf dem vmware-vks ausgeführt wird. Überprüfen Sie die Firewall-Regeln für Port 6443.

Skalierungsvorgang hat keine Auswirkung

Stellen Sie sicher, dass sich der Cluster in der Phase "Running" befindet, bevor Sie skalieren. Cluster in der Phase "Creating" oder "Updating" lehnen Skalierungsvorgänge ab.

Namespace-Löschung unerwartet abgelehnt

Der Namespace-Löschschutz verhindert das Löschen, wenn sich darin TKC-Cluster befinden. Löschen Sie zuerst alle TKC-Cluster im Namespace und versuchen Sie es dann erneut.

Versionskompatibilität

Verwandte Projekte

Lizenz

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• check_vks_compatibilityA
• create_namespaceA
• create_tkc_clusterA
• delete_namespaceA
• delete_tkc_clusterA
• get_harbor_infoA
• get_namespaceA
• get_supervisor_kubeconfigA