tf_examples/fullpipe_chain

vDC → Edge → внешние IP → SNAT → vApp → ВМ → Штурвал

Пример поднимает всю цепочку в Nubes:

• виртуальный датацентр (vDC);
• сетевой шлюз периметра (Edge) с балансировщиком AVI;
• внешние IP на организации;
• SNAT на шлюзе;
• виртуальный каталог (vApp) и виртуальную машину (ВМ) внутри него — с доступом по SSH;
• Kubernetes-кластер Штурвал (сервис 150) на этой сети.

Организацию создайте заранее в ЛК: Terraform её не создаёт и не удаляет. Файлы примера повторяют рабочую конфигурацию стенда, включая флаги «заморозки» при удалении (см. шаг 6) и усыновление уже существующих услуг по имени.

Перед началом: нужен установленный Terraform 1.5 или новее. Провайдер скачается сам при terraform init — отдельно ставить ничего не нужно.

1. Скачайте пример

git clone https://gitea.services.ngcloud.ru/Nail/tf_examples.git
cd tf_examples/fullpipe_chain

2. Возьмите значения в ЛК

Значение	Где взять	Пример
api_token	ЛК → Профиль → Токены → «Технический»	eyJhbGciOi...
organization	ЛК → услуга «Организация в Cloud Director» → название услуги	organ
vdc_network_provider	ЛК → создание vDC → «Сетевой провайдер»	snb1
vdc_provider_vdc	ЛК → создание vDC → «Provider VDC»	Intel Broadwell 2.4
vdc_storage_config	ЛК → создание vDC → доступные дисковые политики	SATA
ip_space_name	ЛК → карточка организации → внешние IP	internet-ipv4-v1
vm_user_public_key	содержимое ~/.ssh/id_ed25519.pub (ssh-keygen создаст пару, если её нет)	ssh-ed25519 AAAA...

Остальные значения уже подставлены в terraform.tfvars.example — меняйте, если нужно.

3. Заполните terraform.tfvars

cp terraform.tfvars.example terraform.tfvars
nano terraform.tfvars      # подставьте значения из шага 2

Полный список параметров — в variables.tf, у каждой переменной есть описание.

4. Выполните команды

terraform init     # один раз — скачает провайдер
terraform plan     # покажет, что будет создано (7 ресурсов: vDC, Edge, IP, SNAT, vApp, ВМ, Штурвал)
terraform apply    # создаст (подтвердить: yes)

5. Проверьте результат

terraform output   # UUID и имена созданных услуг

И в ЛК: появились vDC, Edge, vApp с ВМ и кластер Штурвал, на организации выделены внешние IP, на шлюзе включён SNAT. Повторный terraform plan должен показать No changes.

Адрес ВМ — в terraform output vm_state_flat (поля externalConnect и internalConnect), вход: ssh <vm_user_login>@<externalConnect>.

Кластер Штурвала создаётся десятки минут — провайдер ждёт его (operation_timeout = "60m"), а в ЛК он появится со статусом running. Адреса Kubernetes API и Ingress — в terraform output shturval_state_params (поля kubernetesApiAddress и ingressAddress).

6. Удаление

terraform destroy

По умолчанию пример настроен на «заморозку»: ничего не удаляется из облака.

Ресурс	Что делает destroy	Флаг
Кластер Штурвал	suspend: кластер выключается, данные сохраняются	suspend_on_destroy = true
vDC	suspend	suspend_on_destroy = true
Edge	не трогается: у эджа нет операции suspend	keep_on_destroy = true
SNAT	не выключается	keep_on_destroy = true
Квота внешних IP	не меняется: адреса держит кластер	keep_on_destroy = true
vApp	suspend: выключаются все ВМ внутри каталога	suspend_on_destroy = true
ВМ	suspend	suspend_on_destroy = true

Следующий terraform apply усыновит объекты по имени и разморозит кластер и vDC (adopt_existing_on_create = true → resume). Организация не удаляется никогда.

Полное удаление — осознанно: выставьте keep_on_destroy = false и suspend_on_destroy = false, порядок — кластер → ВМ → vApp → count = 0 → SNAT → Edge → vDC (vApp и vDC удаляются только через 14 дней после suspend).

Состав файлов

Файл	Что делает
versions.tf	версия Terraform и провайдера Nubes
provider.tf	подключение к API (токен, адрес)
variables.tf	все параметры с описанием
vdc.tf	виртуальный датацентр
edge.tf	сетевой шлюз периметра (Edge)
modifiers.tf	внешние IP на организации + SNAT на шлюзе
vm.tf	vApp и ВМ: переменные vApp/ВМ, оба ресурса и их выводы (удаляется целиком — остальное не затронуто)
shturval.tf	Kubernetes-кластер Штурвал: переменные Штурвала, группы воркеров и сам ресурс
outputs.tf	UUID и имена созданных услуг (vDC, Edge, Штурвал)
terraform.tfvars.example	шаблон значений (копируется в terraform.tfvars)

terraform.tfvars с токеном никому не передавайте и не коммитьте в git.