chore: обновить примеры (переменные, шаблоны значений, AGENTS.md)

This commit is contained in:
Repinoid
2026-10-12 10:18:05 +03:00
parent 3ac9700dde
commit 67c14e7dca
7 changed files with 49 additions and 5 deletions
+34
View File
@@ -0,0 +1,34 @@
# 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-приложения |
Для точных полей всегда открывать спеку конкретного ресурса, а не доверять памяти.