tf_docs
Проект документации Terraform.
Репозиторий создан как основа для документации по проекту Terraform (провайдеры, модули, схемы, история изменений и т.д.).
Содержимое будет дополняться по мере развития проекта.
AI-ассистент документации
Сервис — обратный прокси статики документации и эндпоинт AI-ассистента.
Эндпоинт
POST /<stand>/_api/assist — тело {"question": "текст вопроса"}.
Ответ 200:
{
"answer": "ответ по шаблону Роль/Задача/Контекст/Требования/Ограничения",
"sources": [{"title": "...", "url": "/<stand>/..."}],
"meta": {"model": "...", "resource_type": "nubes_...", "elapsed_ms": 1234}
}
Ошибки (JSON {"error": code, "message": ...}): 400/413/415 (невалидный ввод), 429 (rate-limit, Retry-After), 502 (bad_llm_output), 503 (busy / индекс недоступен).
Переменные окружения
| Имя | По умолчанию | Назначение |
|---|---|---|
VM_DOCS_BASE_URL |
— (обязательна) | базовый URL статики (upstream) |
LLM_BASE_URL |
— | https://api.aillm.ru |
LLM_API_KEY |
— | ключ ЛЛМ (брать из Secret, не логировать) |
LLM_MODEL |
gpt-oss-120b |
модель |
ASSIST_MAX_CONCURRENT |
4 |
семафор одновременных вызовов ЛЛМ |
ASSIST_TOTAL_DEADLINE_MS |
40000 |
общий дедлайн запроса |
ASSIST_LLM_TIMEOUT_MS |
25000 |
таймаут одного вызова ЛЛМ |
ASSIST_RATE_PER_WINDOW |
6 |
лимит запросов на IP за окно |
ASSIST_RATE_WINDOW_MS |
60000 |
окно rate-limit |
ASSIST_REPLICAS |
1 |
число реплик (для деления лимита) |
ASSIST_MAX_BODY |
2048 |
макс. размер тела запроса |
ASSIST_TRUSTED_PROXY_CIDR |
— | CIDR доверенного proxy (для X-Forwarded-For) |