`nubes_vc_vm_v3` — Виртуальная машина¶

Разворачивает виртуальную машину в vApp (виртуальном каталоге ВМ) с заданными CPU, памятью, диском, образом и правилами доступа. Поддерживает cloud-init и SSH-ключ.

Инструкция по сервису

Отдельная страница: руководство по сервису.

Специфика Nubes: destroy ≠ удаление

terraform destroy по умолчанию усыпляет инстанс (suspend), а не удаляет. Подробности — в разделе «Жизненный цикл» и в общем руководстве «Как работает провайдер».

Пример использования¶

resource "nubes_vc_vm_v3" "vm" {
  resource_name = "my-vm"

  vapp_uid   = nubes_vapp.group.id # UUID каталога ВМ (сервис 26)
  vm_name    = "web01"
  image_vm   = "ubuntu-22.04"      # значение из Личного кабинета

  vm_cpu  = 1    # 1…64
  vm_ram  = 1    # 1…256 (GB)
  vm_disk = "20" # GB

  ip_space_name    = "internet-ipv4-v1"
  access_ip_list   = ["0.0.0.0/0"]
  user_login       = "myuser"
  user_public_key  = file("~/.ssh/id_ed25519.pub")

  cloud_init = <<-EOT
    #cloud-config
    packages:
      - nginx
  EOT

  access_port_list = [
    { port = "22",    type = "tcp" },
    { port = "10050", type = "tcp" },
  ]

  same_snat = false
}

Argument Reference¶

Имя	Тип	Обязательный	По умолчанию	Описание	Ограничения
`resource_name`	string	да	—	Имя инстанса	—
`ip_space_name`	string	да	—	Тип IP-space (`internet-ipv4-v1` / `internet-antiddos-v1` / `internet-no-antiddos-v1`)	—
`image_vm`	string	да	—	Образ ВМ	значение из ЛК
`user_public_key`	string	да	—	Публичный SSH-ключ пользователя	—
`vapp_uid`	string (uuid)	нет	—	UUID каталога ВМ (сервис 26)	ссылка на `nubes_vapp`
`vm_name`	string	нет	`web01`	Имя ВМ	—
`vm_cpu`	integer	нет	`1`	Количество CPU (шт)	1…64
`vm_ram`	integer	нет	`1`	Объём RAM (GB)	1…256
`vm_disk`	string	нет	—	Размер диска	—
`access_ip_list`	list	нет	`["0.0.0.0/0"]`	Разрешённые адреса	CIDR
`cloud_init`	string	нет	—	Cloud-init конфигурация	—
`user_login`	string	нет	`myuser`	Логин пользователя	—
`same_snat`	bool	нет	`false`	Использовать общий SNAT	`false`, `true`

`access_port_list` (список)¶

Имя	Тип	Обязательный	По умолчанию	Описание
`port`	string	нет	`22`	Порт
`type`	string	нет	`all`	Протокол: `tcp`, `udp`, `all`

Общие атрибуты (есть у всех ресурсов):

Имя	Тип	Обязательный	По умолчанию	Описание
`operation_timeout`	string	нет	—	Максимальное время ожидания операции
`log_level`	string	нет	`none`	Логирование стадий: `none`, `info`, `debug`
`suspend_on_destroy`	bool	нет	`true`	При destroy — усыпить вместо удаления
`keep_on_destroy`	bool	нет	`false`	При destroy — ничего не делать в облаке (state_only)
`adopt_existing_on_create`	bool	нет	`false`	Авто-подхват существующего инстанса при apply

Attribute Reference¶

Имя	Тип	Описание
`id`	string	UUID инстанса
`state_out` / `state_out_flat`	map	Ответ API (адреса ВМ, `instanceUid`, `monitoring`)
`state_params` / `state_params_flat`	map	Параметры, отправленные в API
`vault_secrets`	map (sensitive)	Секреты из Vault
`vault_url` / `vault_user_path`	string	Адрес/путь Vault
`vault_fields`	list	Список доступных ключей секретов

Жизненный цикл ¶

Флаг	Дефолт	Поведение при `destroy`
`suspend_on_destroy`	`true`	ВМ переводится в `suspend` (не удаляется)
`suspend_on_destroy`	`false`	Выполняется операция `delete` — инстанс удаляется в облаке
`keep_on_destroy`	`false`	Если `true` — ресурс вообще не трогается в облаке (state_only)

Возврат из suspend: повторный terraform apply с adopt_existing_on_create = true — провайдер найдёт ВМ по имени и выполнит resume.

Зачем нужно усыпление

suspend — временная остановка: ресурсы высвобождаются, а инстанс можно вернуть в работу в любой момент повторным apply.

Удаление усыплённого инстанса

Удалить усыплённый инстанс можно, когда он пробыл в suspend 15 минут.

⚠️ Из Terraform это невозможно — операция delete для усыплённого инстанса недоступна. Удаляйте его вручную в Личном кабинете (ЛК).

Инстанс в статусе «not created» (после упавшего create) блокирует имя и не удаляется через API — чистится вручную в Личном кабинете.
redeploy запускается из Terraform сменой поля git_revision; reconcile — ресурсом nubes_service_operation (operation = "reconcile").

Operations¶

Операция	Доступно из Terraform	Комментарий
`create`	✅ `apply`	Создание ВМ
`modify`	✅ `apply`	Меняются `vm_cpu`, `vm_ram`, `vm_disk`, `ip_space_name`, `access_ip_list`, `access_port_list`, `same_snat`
`suspend`	✅ `destroy` (при `suspend_on_destroy=true`)	Остановка ВМ
`resume`	✅ `apply` (при `adopt_existing_on_create=true`)	Запуск ВМ
`delete`	✅ `destroy` (`suspend_on_destroy=false`)	Удаление инстанса в облаке. Только для работающего (`running`); усыплённый — вручную в ЛК
`reconcile`	✅ через `nubes_service_operation`	Синхронизация состояния (универсальная операция)
`redeploy`	✅ `apply` (при смене `git_revision`)	Пересборка из git (поле-триггер)

nubes_vc_vm_v3 — Виртуальная машина¶