fix(fullpipe_chain): структура как в DEV_STAND (versions/provider/variables/outputs), все значения через переменные, организация по имени вместо UUID, провайдер 2.0.21

modify_resources/README.md

@@ -1,45 +1,46 @@
-# Ресурсы-модификаторы: аллокация IP на орге + SNAT на шлюзе
+# Внешние IP на организации и SNAT на шлюзе
 
-Пример показывает два ресурса, которые выполняют операции `modify` над **уже существующими**
-услугами (создаются один раз вручную в ЛК):
+Два ресурса, которые работают с **уже существующими** услугами (создаются вручную в ЛК):
 
-| Ресурс | Что делает | Параметр операции |
-|---|---|---|
-| `nubes_vc_org_ip_allocation` | выделяет внешние IP на организации Cloud Director | `vIPConfigure` (replace массива) |
-| `nubes_vc_nsxt_snat` | включает/выключает SNAT на сетевом шлюзе периметра | `ipSpaceName` (`no-needed` = выключено) |
+| Ресурс | Что делает |
+|---|---|
+| `nubes_vc_org_ip_allocation` | выделяет внешние IP на организации |
+| `nubes_vc_nsxt_snat` | включает SNAT на сетевом шлюзе |
 
-## Зачем они нужны
+Если нужно поднять всё сразу (vDC + шлюз + IP + SNAT), смотрите соседний пример `fullpipe_chain`.
 
-В схеме ресурсов-инстансов (`nubes_vc_org`, `nubes_vc_nsxt`) эти параметры есть только в операции
-`modify`, а `create` их не отправляет. Поэтому «одним ресурсом» цепочку не собрать: отдельные
-ресурсы нужны, чтобы всё поднималось **в одном `apply`** и в правильном порядке.
+**Перед началом:** нужен установленный Terraform 1.5 или новее. Версия провайдера указана в `main.tf` —
+при `terraform init` он скачается из реестра автоматически.
 
 ## Что нужно заполнить
 
-| Переменная | Где брать |
-|---|---|
-| `api_token` | ЛК → Профиль → Токены → «Технический» |
-| `org_uid` | UUID услуги «Организация в Cloud Director» (из URL карточки услуги в ЛК) |
-| `nsxt_uid` | UUID услуги «Сетевой шлюз периметра (Edge)» |
-| `ip_space_name` | Имя ipSpace, доступное организации (например `internet-ipv4-v1`) |
-| `ip_count` | Сколько внешних IP выделить (например `3`) |
+```bash
+cp terraform.tfvars.example terraform.tfvars
+```
 
-## Порядок и зависимости
+| Переменная | Где взять | Пример |
+|---|---|---|
+| `api_token` | ЛК → Профиль → Токены → «Технический» | `eyJhbGciOi...` |
+| `organization` | название услуги «Организация в Cloud Director» в ЛК | `organ` |
+| `nsxt_uid` | UUID услуги «Сетевой шлюз периметра (Edge)» из карточки услуги | `0000…` |
+| `ip_space_name` | имя ipSpace, доступное организации | `internet-ipv4-v1` |
+| `ip_count` | сколько внешних IP выделить (строкой) | `3` |
 
-`nubes_vc_nsxt_snat` **обязан** зависеть от `nubes_vc_org_ip_allocation`: имя ipSpace берётся из
-аллокации организации. В примере это явный `depends_on`.
-
-## Удаление (destroy)
-
-- `nubes_vc_org_ip_allocation` — отправляет обратный `modify` с `count=0` (квота обнуляется);
-- `nubes_vc_nsxt_snat` — отправляет `ipSpaceName = "no-needed"` (SNAT выключается).
-
-Если снимать не нужно — поставь `keep_on_destroy = true`.
+`terraform.tfvars` с токеном никому не передавайте и не коммитьте в git.
 
 ## Запуск
 
 ```bash
-terraform init
-terraform plan
-terraform apply
+terraform init     # один раз — скачает провайдер
+terraform plan     # покажет, что будет создано
+terraform apply    # создаст (подтвердить: yes)
 ```
+
+## Удаление
+
+```bash
+terraform destroy
+```
+
+SNAT выключается, квота IP обнуляется. Сами услуги (организация, шлюз) не удаляются.
+Если снимать не нужно — поставьте `keep_on_destroy = true`.