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,52 @@
+# Resource nubes_vc_vm
+
+Service ID: `23`
+
+Service Name: VM в Cloud Director (старый формат) (vc_vm)
+
+[Manual](vc_vm.md) | [Create params](vc_vm_params_create.md) | [Modify params](vc_vm_params_modify.md) | [Output params](vc_vm_outputs.md) | [Operations](vc_vm_ops.md) | [Example](vc_vm_example.md)
+
+## Copy-ready manifest (`vc_vm_main.tf`)
+
+```hcl
+terraform {
+  required_providers {
+    nubes = {
+      source  = "terra.k8c.ru/nubes/nubes"
+      version = "2.1.23"
+    }
+  }
+}
+
+# Токен доступа api_token к Nubes API  — замените на реальный.
+provider "nubes" {
+  api_token    = "token_***"
+  api_endpoint = "https://deck-api.ngcloud.ru/api/v1/index.cfm"
+}
+resource "nubes_vc_vm" "baza" {
+  vapp_uid = "TODO" # InstanceUid vApp. vApp должен быть создан
+  ip_space_name = "TODO" # Брать из свойств ресурсной платформы .vcd.ipSpace Имя IP-space для выделения внешнего IP (IP выделяется обязательно)
+
+  # Параметры, имеющие значение по умолчанию, если не меняете - эти параметры не обязательно прописывать в манифесте
+  vm_name = "vm0001" # Имя ВМ. Не поддерживает спец-символы
+  vm_cpu = 2 # CPU
+  vm_ram = 2 # RAM (GB)
+  vm_disksize = 10 # Размер диска под сервис (GB)
+  template_name = "RockyLinux_9-16G" # ОС
+  access_ip_list = "79.111.119.78/32 185.247.187.1/32" # Вставить содержимое из 'curl ifconfig.io' IP адреса в CIDR формате через пробел для настройки аксес листов
+}
+```
+
+## Outputs usage
+
+```hcl
+# Выходные параметры можно использовать как
+nubes_vc_vm.baza.state_params["имя_ключа"]
+nubes_vc_vm.baza.state_out["имя_ключа"]
+nubes_vc_vm.baza.state_params_flat["имя_ключа"]
+nubes_vc_vm.baza.state_out_flat["имя_ключа"]
+nubes_vc_vm.baza.vault_secrets["имя_ключа"]
+nubes_vc_vm.baza.vault_url
+nubes_vc_vm.baza.vault_user_path
+nubes_vc_vm.baza.vault_fields
+```