add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,62 @@
+# Resource: nubes_vdc (Виртуальный датацентр)
+
+`nubes_vdc` позволяет создавать и управлять Виртуальным датацентром (vDC) через платформу Nubes.
+
+Виртуальный датацентр (vDC) — это логическая изолированная среда в VMware Cloud Director, предназначенная для размещения и управления виртуальными машинами.
+
+## Пример использования
+
+```text
+resource "nubes_organization" "my_org" {
+  name = "My Organization"
+  # ... другие параметры организации
+}
+
+resource "nubes_vdc" "my_vdc" {
+  display_name     = "Production-vDC"
+  organization_uid = nubes_organization.my_org.id
+  
+  # Системные параметры платформы (зависят от организации)
+  provider_vdc     = "v1cl4-vsan-pvdc"
+  network_pool     = "nsxt-v1cl1-geneve-np"
+
+  # Гарантированные доли ресурсов (задаются при создании)
+  cpu_allocation_pct = 20
+  ram_allocation_pct = 20
+
+  # Квоты ресурсов (можно изменять через modify)
+  cpu_quota = 10
+  ram_quota = 20
+
+  # Дисковые политики
+  # JSON формат: [{"name": "PolicyName", "size": "GB"}]
+  storage_profiles = jsonencode([
+    {
+      name = "storoj"
+      size = "100"
+    }
+  ])
+  
+  deletion_protection = false # Если false, при destroy ресурс будет заморожен (suspend)
+}
+```
+
+## Аргументы
+
+* `display_name` (String, Required) - Имя vDC.
+* `organization_uid` (String, Required) - UUID Организации (param 30).
+* `provider_vdc` (String, Required) - Provider VDC в Cloud Director (param 335).
+* `network_pool` (String, Required) - Network Pool в Cloud Director (param 366).
+* `cpu_allocation_pct` (Int, Required) - Гарантированная доля ЯДЕР % (param 397). **Неизменяемый параметр**.
+* `ram_allocation_pct` (Int, Required) - Гарантированная доля ОЗУ % (param 398). **Неизменяемый параметр**.
+* `cpu_quota` (Int, Required) - Количество аллоцированных ядер (param 557).
+* `ram_quota` (Int, Required) - Количество аллоцированной ОЗУ в GB (param 558).
+* `storage_profiles` (String, Required) - Конфигурация Storage в формате JSON-строки (param 361).
+* `deletion_protection` (Boolean, Optional) - Если `true` (по умолчанию), `terraform destroy` только удаляет ресурс из стейта. Если `false`, выполняется операция `suspend`, и ресурс удаляется облаком через 14 дней.
+
+## Импорт
+
+Импорт осуществляется по UUID инстанса:
+```bash
+terraform import nubes_vdc.my_vdc <instance_uuid>
+```