docs: detailed SHTURVAL_MGMT README for non-TF users

SHTURVAL_MGMT/README.md

@@ -1,3 +1,35 @@
-# Штурвал — Management кластер
+# Штурвал — Management Kubernetes кластер
 
-`nubes_vc_mgmt_sthutrval_cluster`. Деплоится через Terraform.
+Разворачивает management-кластер Kubernetes через сервис Nubes «Штурвал» (сервис 148).
+
+## Что нужно заполнить
+
+### `terraform.tfvars` — 3 значения
+
+Скопировать `terraform.tfvars.example` → `terraform.tfvars`, заполнить:
+
+| Параметр | Где брать | Пример |
+|---|---|---|
+| `api_token` | ЛК → Профиль → Токены → «Технический» | `eyJ...` |
+| `realm` | Оставить `sandbox.nubes.ru` (dev-стенд) | `sandbox.nubes.ru` |
+| `sizing_policy` | Зависит от доступных квот. Уточнить у администратора платформы | `TKG 4CPU 8RAM` |
+
+### `locals.tf` — настройки кластера (опционально)
+
+| Параметр | Что значит |
+|---|---|
+| `shturval_cluster_name` | Имя кластера |
+| `shturval_app_version` | Версия Штурвала: `2.13.1`, `2.12.1` или `2.11.0` |
+| `shturval_cp_sizing_policy` | Размер control plane: `TKG 4CPU 8RAM`, `TKG 8CPU 16RAM`, `TKG 16CPU 32RAM` |
+| `shturval_cp_count` | Количество control plane нод: `1`, `3` или `5` |
+| `shturval_worker_config` | Группы воркеров — JSON с `groupName`, `sizingPolicy`, `sizingDisk`, `count` |
+| `shturval_api_access_ip_list` | IP-список для доступа к API. `[]` = без ограничений |
+| `shturval_ingress_access_ip_list` | IP-список для доступа к Ingress. `[]` = без ограничений |
+
+## Состав
+
+| Файл | Что |
+|---|---|
+| `main.tf` | Провайдер + переменные |
+| `locals.tf` | Все настройки кластера |
+| `shturval_mgmt.tf` | Ресурс `nubes_vc_mgmt_sthutrval_cluster` |