add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,23 @@
+# Глоссарий
+
+- instance — экземпляр сервиса в Nubes Cloud.
+- instanceOperation — асинхронная операция над instance (create/modify/delete/suspend/resume).
+- cfsParams — список параметров операции, получаемый через manifest операции.
+- svcOperationCfsParamId — ID параметра операции, различается для create и modify.
+- dtFinish — единственный надёжный индикатор завершения операции.
+- isSuccessful — результат операции после dtFinish.
+- resourceRealm — окружение/realm; иногда обязателен и задаётся пользователем.
+- display_name — человекочитаемое имя; используется для adopt/resume.
+- adopt_existing_on_create — явное разрешение на adopt/import при найденном `running` ресурсе (default: false).
+- suspend_on_destroy — флаг destroy-поведения для сервисов с `suspend`: `true` -> suspend, `false` -> state-only (default: true).
+- suspend — мягкое удаление (карантин/retention).
+- validate-cfs — проверка параметров операции до run.
+- state.out — выходные данные API; при отсутствии задаются null.
+- computed — вычисляемые поля, должны быть известны после apply.
+- registry protocol — API Terraform Registry (discovery + versions + download).
+- signing_keys — публичные GPG ключи, выдаваемые registry.
+- NLI — Natural Language Infrastructure (AI-парсинг инструкций).
+- gitea.services.ngcloud.ru — внешний Gitea хост; возможны проблемы доверия TLS/доступа из кластера.
+- gitea-naeel.giteak8s.services.ngcloud.ru — внутренний Gitea хост; успешные деплои при доступности контента.
+- git_path mirror — зеркальный репозиторий на собственном Gitea для обхода проблем внешнего хоста.
+- API meta dump (test) — полная выгрузка параметров API для окружения test, используется для проверки универсального генератора YAML.