`nubes_dummy` — Болванка¶

Тестовая «болванка» платформы: создаёт инстанс, который можно заставить ждать, падать на старте или в процессе, и записывать/не записывать данные в CMDB и Vault. Служит для проверки поведения провайдера на разных сценариях (успех, отказ, откат), а не для рабочей нагрузки.

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

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

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

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

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

resource "nubes_dummy" "test" {
  resource_name  = "my-dummy"
  resource_realm = "dummy"

  duration_ms = 0     # задержка перед завершением
  fail_at_start  = false
  fail_in_progress = false

  bodymessage = "hello"
  json_example = jsonencode({ foo = "bar" })

  map_example = {
    subparam1 = "a"
    subparam2 = "b"
    secret    = "s3cr3t"
  }

  map_fixed = {
    param1   = 1
    param2   = "1"
    param3   = 1
    bol1     = false
    min_str1 = "abracadabra"
  }

  arr = ["test"]
}

Argument Reference¶

Имя	Тип	Обязательный	По умолчанию	Описание	Ограничения
`resource_name`	string	да	—	Имя инстанса	—
`duration_ms`	integer	нет	`0`	Пауза (sleep) перед завершением, мс	—
`fail_at_start`	bool	нет	`false`	Аварийно завершить джоб, ничего не записав в CMDB	`false`, `true`
`fail_in_progress`	bool	нет	`false`	Начать джоб и упасть в процессе, не записав в CMDB	`false`, `true`
`where_fail`	integer	нет	`1`	Где упасть (с `fail_in_progress`): 1 — prepare, 2 — блок Data fill, 3 — после записи в Vault	`1`, `2`, `3`
`resource_realm`	string	нет	`dummy`	«Платформа» развёртывания	`dummy`
`bodymessage`	string	нет	—	Дата, уходящая в Vault	—
`json_example`	string	нет	—	Для тестирования интерфейса	—
`nested_ref_example`	string	нет	—	—	—
`arr`	list	да	—	Тестовый список	—

`map_example`¶

Имя	Тип	Обязательный	По умолчанию	Описание
`subparam1`	string	нет	—	Для администратора
`subparam2`	string	нет	—	—
`secret`	string	нет	—	Секрет

`map_fixed`¶

Имя	Тип	Обязательный	По умолчанию	Описание
`param1`	integer	нет	`1`	Integer, секрет
`param2`	string	нет	`1`	`1`, `2`, `3`
`param3`	integer	нет	`1`	Целое положительное
`bol1`	bool	нет	`false`	Булевский
`min_str1`	string	нет	`abracadabra`	Не меньше 10 символов

`array_map_fixed_example`¶

Имя	Тип	Обязательный	По умолчанию	Описание
`param1`	integer	да	—	—
`param2`	string	да	—	`1`, `2`, `3`
`param3`	integer	нет	`1`	—
`bol1`	bool	да	—	`false`, `true`
`min_str1`	string	да	—	Не меньше 10 символов

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

Имя	Тип	Обязательный	По умолчанию	Описание
`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
`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_on_destroy`

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

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

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

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

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

Инстанс в статусе «not created» (после упавшего create) блокирует имя и не удаляется через API — чистится вручную в Личном кабинете.

Operations¶

Операция	Доступно из Terraform	Комментарий
`create`	✅ `apply`	Создание инстанса
`modify`	✅ `apply`	Меняются `duration_ms`, `fail_at_start`, `fail_in_progress`, `where_fail`, `bodymessage`, `map_example`, `json_example`
`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_dummy — Болванка¶