feat(vm): add vApp + VM terraform example

2026-03-25 08:17:08 +03:00
parent 3404af578b
commit bc0e00acca
10 changed files with 482 additions and 1 deletions
@@ -0,0 +1,93 @@
+# Пример: Виртуальная машина (vApp + VM) в Nubes vDC
+
+Создаёт:
+- **vApp** — виртуальный каталог (контейнер для ВМ в VMware vDC)
+- **ВМ** — Ubuntu 22.04, 2 CPU / 2 GB RAM / 20 GB disk
+
+---
+
+## Что нужно сделать перед запуском
+
+### 1. Сгенерировать SSH-ключ
+
+Публичный ключ прописывается в ВМ при создании — это единственный способ зайти по SSH.
+Приватный ключ нужен хранить у себя.
+
+```bash
+ssh-keygen -t ed25519 -f ~/.ssh/sless-demo-vm -N "" -C "sless-demo-vm"
+```
+
+Публичный ключ (`~/.ssh/sless-demo-vm.pub`) — строка вида:
+```
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... sless-demo-vm
+```
+
+### 2. Заполнить terraform.tfvars
+
+Открыть файл `terraform.tfvars` и заменить значения:
+
+```hcl
+# Ваш API-токен из панели Nubes
+api_token = "ВСТАВИТЬ_ТОКЕН"
+
+# Публичный ключ из шага 1
+vm_public_key = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA..."
+```
+
+> **Токен** — берётся в панели Nubes: профиль → API-токены.  
+> **Ключ** — содержимое файла `~/.ssh/sless-demo-vm.pub` (публичный, не приватный!).
+
+---
+
+## Запуск
+
+```bash
+cd examples/VM
+
+terraform init
+terraform apply
+```
+
+После `apply` в выводе будет:
+
+```
+Outputs:
+
+vm_id    = "..."
+vm_state = {
+  "externalIp" = "1.2.3.4"
+  ...
+}
+vapp_id  = "..."
+```
+
+---
+
+## Подключение по SSH
+
+```bash
+ssh -i ~/.ssh/sless-demo-vm ubuntu@<externalIp из outputs>
+```
+
+Логин — `ubuntu` (задан в `vm.tf`).
+
+---
+
+## Удаление
+
+```bash
+terraform destroy
+```
+
+Порядок автоматический: сначала suspend → потом delete. Без suspend удаление упадёт с ошибкой — это поведение Nubes, параметр `suspend_on_destroy = true` в ресурсах решает это.
+
+---
+
+## Что можно менять
+
+| Параметр | Файл | Примечание |
+|----------|------|-----------|
+| `vm_cpu`, `vm_ram`, `vm_disk` | `vm.tf` | Можно менять и переприменять |
+| `resource_name`, `vapp_name` | `vapp.tf` | **Не изменяется после создания** |
+| `image_vm`, `user_login`, `user_public_key` | `vm.tf` | **Не изменяется после создания** |
+| `vdc_uid`, `nsxt_uid` | `vapp.tf` | **Не изменяется после создания** |