VMware VKS

Автор: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com Это проект, созданный сообществом инженером VMware, а не официальный продукт VMware. Официальные инструменты разработчика VMware см. на developer.broadcom.com.

English | 中文

MCP Skill + CLI для управления VMware vSphere Kubernetes Service (VKS) — кластеры Supervisor, пространства имен vSphere и жизненный цикл кластеров VKS. 20 инструментов MCP.

👁 License: MIT

Сопутствующие навыки

Часть семейства навыков VMware MCP. Каждый навык отвечает за отдельную область — устанавливайте только то, что вам нужно.

Related MCP server: vmware-nsx

Предварительные требования

• vSphere 8.0+ — API управления рабочими нагрузками (Supervisor) требуют vSphere 8.x

• Включенное управление рабочими нагрузками — WCP должен быть включен как минимум на одном вычислительном кластере

• Лицензия — vSphere Kubernetes Service (Enterprise Plus или VMware Cloud Foundation)

После настройки выполните vmware-vks check, чтобы убедиться, что все требования выполнены.

Быстрый старт

# 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

Типовые рабочие процессы

Развертывание нового кластера TKC

1. Проверка совместимости → vmware-vks check

2. Список доступных версий K8s → vmware-vks tkc versions -n dev

3. Создание пространства имен (если нужно) → vmware-vks namespace create dev --cluster domain-c1 --storage-policy vSAN --cpu 16000 --memory 32768 --apply

4. Создание кластера TKC → 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 → vmware-vks kubeconfig get dev-cluster -n dev

Масштабирование рабочих узлов для нагрузочного тестирования

1. Проверка текущего состояния → vmware-vks tkc get dev-cluster -n dev

2. Масштабирование вверх → vmware-vks tkc scale dev-cluster -n dev --workers 6

3. Мониторинг прогресса → vmware-vks tkc get dev-cluster -n dev (отслеживание фазы)

4. Масштабирование вниз после теста

Управление ресурсами пространства имен

1. Список пространств имен → vmware-vks namespace list

2. Проверка использования → vmware-vks storage -n dev

3. Обновление квоты → vmware-vks namespace update dev --cpu 32000 --memory 65536

Справочник инструментов (20 инструментов)

Supervisor

Пространство имен

TKC

Доступ

Архитектура

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

# 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

После uv tool install vmware-vks запустите сервер MCP одной командой (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

Конфигурация агента

Добавьте в конфигурацию MCP вашего ИИ-агента:

{
 "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

Находитесь за корпоративным TLS-прокси? uvx может завершиться ошибкой invalid peer certificate: UnknownIssuer. Используйте рекомендованный формат vmware-vks mcp выше (сеть не требуется) или установите UV_NATIVE_TLS=true.

Безопасность

Устранение неполадок

Ошибка "VKS not compatible"

Управление рабочими нагрузками должно быть включено в vCenter. Проверьте: vCenter UI -> Workload Management. Требуется vSphere 8.x+ с лицензией Enterprise Plus или VCF.

Ошибка создания пространства имен "storage policy not found"

Сначала выведите список доступных политик: vmware-vks supervisor storage-policies. Имена политик чувствительны к регистру.

Кластер TKC застрял в фазе "Creating"

Проверьте события Supervisor в vCenter. Распространенные причины: недостаточно ресурсов на хостах ESXi, сетевые проблемы с NSX-T или политика хранения недоступна на целевом хранилище данных.

Ошибка получения Kubeconfig

API-эндпоинт Supervisor должен быть доступен с машины, на которой запущен vmware-vks. Проверьте правила брандмауэра для порта 6443.

Операция масштабирования не дает эффекта

Перед масштабированием убедитесь, что кластер находится в фазе "Running". Кластеры в фазе "Creating" или "Updating" отклоняют операции масштабирования.

Удаление пространства имен неожиданно отклонено

Защита удаления пространства имен предотвращает удаление, если внутри существуют кластеры TKC. Сначала удалите все кластеры TKC в пространстве имен, затем повторите попытку.

Совместимость версий

Связанные проекты

Лицензия

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