35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
# 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-приложения |
|
|
|
|
Для точных полей всегда открывать спеку конкретного ресурса, а не доверять памяти.
|