tf_examples/AGENTS.md

AGENTS.md — инструкция по каталогу tf_examples

Для ИИ-агента в IDE. Этот каталог — готовые примеры использования провайдера Nubes.

Структура примера

tf_examples/<name>/
  main.tf                  # ресурсы
  variables.tf             # объявления переменных
  terraform.tfvars.example # ПАРАМЕТРЫ (этот файл — то, что правят/проверяют)
  README.md                # что делает пример

Как работать с примером

1. Не выдумывать поля: сверять terraform.tfvars.example со спекой ресурса. Источники схемы: страница ресурса на сайте доков (https://tf-docs.nodejsk8s.dev.nubes.ru/<stand>/<service>/) либо машиночитаемая схема https://tf-docs.nodejsk8s.dev.nubes.ru/<stand>/schema/<service>.json; если этот репозиторий склонирован внутри провайдера — ещё ../provider/resources_yaml/*.yaml.
2. Секреты — только в secrets.auto.tfvars (в .gitignore), НЕ в tfvars.
3. terraform plan/apply запускает пользователь.

Маппинг «пример → ресурсы»

Пример	Ресурсы (обычно)
CRUD/	nubes_postgres, nubes_s3_bucket, nubes_kafka, nubes_nodejs/flask/lucee
Maria_CRUD/	nubes_mariadb
SHTURVAL_MGMT/	nubes_k8s_* (Штурвал)
fullpipe_chain/, iot-rmq-demo/	nubes_rabbitmq + IoT-приложения

Для точных полей всегда открывать спеку конкретного ресурса, а не доверять памяти.