Как развернуть vDC, Edge, внешние IP, SNAT и кластер Штурвал

Пошаговая инструкция. Готовые файлы примера — в репозитории tf_examples, папка fullpipe_chain.

Что получится в итоге:

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

Организацию создайте заранее в ЛК — Terraform её не создаёт и не удаляет. Кластер Штурвал создаётся десятки минут, поэтому провайдер ждёт его до часу (operation_timeout = "60m"); остальные ресурсы — минуты.

Что нужно перед началом

Требование	Зачем	Где смотреть
Terraform 1.5 или новее	работает провайдер	`terraform version`
Токен API	доступ к ЛК	ЛК → Профиль → Токены → «Технический»
Организация в Cloud Director	всё создаётся внутри неё	услуга «Организация в Cloud Director»
Edge с балансировщиком AVI	без ALB кластер Штурвал не поднимется	`nsxt_need_enable_avi = true`, `nsxt_virtual_services_count >= 3`
Не меньше 3 внешних IP	адрес Kubernetes API, адрес Ingress и запас	`ip_count = "3"`
SNAT на Edge	выход в интернет для машин кластера	ресурс `nubes_vc_nsxt_snat`

Порядок из чек-листа услуги 150 (именно так связаны ресурсы в примере): организация → vDC → Edge (ALB, AVI ≥ 3) → внешние IP (≥ 3) → SNAT → кластер Штурвал. Минимум для кластера: 1 мастер-нода и 1 воркер-нода по 4 vCPU / 8 ГБ RAM / 50 ГБ диска.

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

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

Понадобится Terraform 1.5 или новее. Провайдер скачается сам при terraform init.

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`

3. Заполните значения

cp terraform.tfvars.example terraform.tfvars
nano terraform.tfvars

Файл terraform.tfvars выглядит так:

# Токен из ЛК
api_token = "eyJhbGciOi..."

# Организация из ЛК (создана заранее)
organization = "organ"

# Внешние IP
ip_space_name = "internet-ipv4-v1"
ip_count      = "3"

# vDC
vdc_resource_name    = "fullpipe-vdc"          # имя услуги в ЛК, любое
vdc_network_provider = "snb1"                  # ЛК → создание vDC → «Сетевой провайдер»
vdc_provider_vdc     = "Intel Broadwell 2.4"   # ЛК → создание vDC → «Provider VDC»
vdc_cpu_allocated    = 8                       # vCPU, шт.
vdc_cpu_guaranteed   = 0                       # резервирование vCPU, %: 0, 50 или 80
vdc_mem_allocated    = 32                      # RAM, ГБ
vdc_storage_config   = "[{\"name\":\"SATA\",\"size\":\"200\"}]"   # политика и размер, ГБ

# Edge (сетевой шлюз периметра)
nsxt_resource_name          = "fullpipe-edge"  # имя услуги в ЛК, любое
nsxt_vdc_type               = "vdc"            # родитель: vdc или vdcGroup
nsxt_need_enable_avi        = true             # балансировщик AVI (ALB)
nsxt_virtual_services_count = 3                # виртуальных сервисов AVI: 1..4 (Штурвал: не меньше 3)
nsxt_ip_addr_pool           = "10.10.102.0/24" # пул адресов routed-сети, маска /24
nsxt_main_dns               = "81.22.46.22"    # основной DNS
nsxt_second_dns             = "185.247.187.77" # второй DNS

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

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

terraform init     # один раз — скачает провайдер
terraform plan     # покажет, что будет создано: 5 ресурсов
terraform apply    # создаст (подтвердить: yes)

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

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

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

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

6. Удаление: «заморозка» вместо удаления

terraform destroy

По умолчанию пример повторяет рабочую конфигурацию — при 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`

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

Полное удаление — осознанно: поставьте keep_on_destroy = false и suspend_on_destroy = false и удаляйте по порядку: кластер → квота IP (count = 0) → SNAT → Edge → vDC. Квоту нельзя опустить ниже занятых адресов, поэтому — только после удаления кластера; vDC удаляется лишь через 14 дней после suspend.

Файлы примера

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

Подробнее про два последних ресурса — на странице «Ресурсы-модификаторы (IP организации, SNAT)».

8.8 KiB Raw Blame History