# Штурвал — Management Kubernetes кластер

Разворачивает 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` |

## Запуск

```bash
terraform init     # один раз — скачает провайдер
terraform plan     # покажет что будет создано, без реальных изменений
terraform apply    # создать кластер (подтвердить: yes)
```

После `apply` кластер появится в ЛК → Штурвал.