`nubes_llm_ai` — ML Улей¶

Доступ к большим языковым моделям (LLMaaS) через OpenAI-совместимое API. Инстанс представляет организацию (тенант) на LLM-платформе; внутри создаются команды и API-ключи.

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

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

Специфика Nubes: destroy для этого ресурса удаляет организацию

terraform destroy удаляет инстанс из облака и из Terraform-state. Усыпление (suspend) у этого сервиса не поддерживается. Подробности — в разделе «Жизненный цикл» и в общем руководстве «Как работает провайдер».

⚠️ На одного контрагента может быть создана только одна организация в LLMaaS.

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

resource "nubes_llm_ai" "org" {
  resource_name = "my-llm-org"
  # resource_realm = "llmAi.aillm.ru" # фиксирован (LLM-платформа)
}

Argument Reference¶

Имя	Тип	Обязательный	По умолчанию	Описание
`resource_name`	string	да	—	Имя инстанса (организации)
`resource_realm`	string	нет	`llmAi.aillm.ru`	«Платформа» — LLM-сервис (значение фиксировано)

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

Имя	Тип	Обязательный	По умолчанию	Описание
`operation_timeout`	string	нет	—	Максимальное время ожидания операции
`log_level`	string	нет	`none`	Логирование стадий: `none`, `info`, `debug`
`keep_on_destroy`	bool	нет	`false`	При destroy — ничего не делать в облаке (state_only)
`adopt_existing_on_create`	bool	нет	`false`	Авто-подхват существующего инстанса при apply

Attribute Reference¶

Имя	Тип	Описание
`id`	string	UUID инстанса
`state_out.connectionUrl`	string	Endpoint API: `https://api.aillm.ru/v1/chat/completions`
`state_params.resourceRealm`	map	`llmAi.aillm.ru`
`state_params` / `state_params_flat`	map	Параметры, отправленные в API
`vault_secrets`	map (sensitive)	Секретов нет
`vault_fields`	list	`[]`
`vault_url` / `vault_user_path`	string	Адрес/путь Vault

output "llm_endpoint" { value = nubes_llm_ai.org.state_out_flat["connectionUrl"] }

Жизненный цикл ¶

terraform destroy удаляет организацию из облака и из Terraform-state. Усыпление (suspend) у этого сервиса не поддерживается — атрибута suspend_on_destroy нет.

Флаг	Дефолт	Поведение при `destroy`
`keep_on_destroy`	`false`	Если `true` — ресурс остаётся в облаке (`state_only`); удаление в облаке не выполняется

Инстанс в статусе «not created» (после упавшего create) блокирует имя и не удаляется через API — чистится вручную в Личном кабинете.
reconcile запускается из Terraform ресурсом nubes_service_operation (operation = "reconcile", уникальный run_id).

Подресурсы¶

`nubes_llm_ai_team`¶

Имя	Тип	Обязательный	По умолчанию	Описание	Ограничения
`llm_ai_id`	string (uuid)	да	—	UUID организации	—
`team_name`	string	да	—	Имя команды	только латиница и цифры
`models`	list	да	—	Доступные модели	JSON-массив
`rpm_limit`	integer	нет	`60`	Лимит запросов в минуту	≥ 1
`tpm_limit`	integer	нет	`100000`	Лимит токенов в минуту	≥ 1

`nubes_llm_ai_secrets`¶

Имя	Тип	Обязательный	По умолчанию	Описание	Ограничения
`llm_ai_id`	string (uuid)	да	—	UUID организации	—
`team_name`	string	да	—	Имя команды, которой выдаётся ключ	—
`key_name`	string	да	—	Имя API-ключа	только латиница и цифры, без пробелов
`models`	list	да	—	Доступные модели	JSON-массив
`rpm_limit`	integer	нет	`60`	Лимит запросов в минуту	≥ 1
`tpm_limit`	integer	нет	`100000`	Лимит токенов в минуту	≥ 1

Команды и API-ключи

Для создания команд и ключей требуется операция reconcile у инстанса. Запустите её из Terraform ресурсом nubes_service_operation у ресурса инстанса.

Operations¶

Операция	Доступно из Terraform	Комментарий
`create`	✅ `apply`	Создание организации
`delete`	✅ `destroy`	Удаление организации
`create_team` / `modify_team` / `delete_team`	нет	Требуется предварительный `reconcile` (ресурс `nubes_service_operation`)
`create_secrets` / `update_secrets` / `delete_secrets`	нет	Зависят от команды
`reconcile`	✅ через `nubes_service_operation`	Синхронизация состояния (универсальная операция)

nubes_llm_ai — ML Улей¶