refactor: единый registry.env + очистка profile.env от registry-параметров + синхронизация build-provider.sh

2026-08-09 15:56:51 +04:00
parent 621d8c2738
commit 260766e0b2
11 changed files with 101 additions and 31 deletions
@@ -0,0 +1,69 @@
+# Рефакторинг конфигурации реестра — история решений
+
+Дата: 2026-08-09
+
+## Контекст
+
+При заливке провайдера в DEV-стенд (`nubes-dev`) возникла ошибка:
+```
+No such property: resourceRealm for class: Script26
+```
+
+Провайдер был собран из YAML'ов TEST-стенда, но запущен против DEV API.
+У разных стендов — разные API, разные скрипты бэкенда, разные параметры.
+
+## Проблема 1: схема версий
+
+**Вопрос**: почему `5.1.17` нельзя заливать в DEV?
+
+**Ответ**: первая цифра версии жёстко привязана к стенду:
+- `2.*` = PROD
+- `3.*` = DEV
+- `5.*` = TEST
+
+Источник: `docs/ops/STANDS.md`
+
+## Проблема 2: хардкод старых доменов
+
+**Вопрос**: почему скрипты ссылаются на `registry.kube5s.ru`, `go-registry.containerk8s.dev.nubes.ru`?
+
+**Ответ**: реестр переехал на `tf-registry.containerk8s.services.ngcloud.ru`, но:
+- `profile.env` (все 3 стенда) — старые REGISTRY_HOST, S3_BUCKET
+- `build-provider.sh` — старый дефолт REGISTRY_HOSTNAME
+- `docs-generator/main.go` — хардкод `registry.kube5s.ru/nubes-dev/nubes`
+
+## Проблема 3: размазанная конфигурация
+
+**Вопрос**: почему registry-настройки в 6 разных местах?
+
+**Ответ**: исторически сложилось. Реестр воспринимался как часть стенда,
+а не как независимый сервис.
+
+## Решение: единый `registry.env`
+
+**Принцип**: реестр — НЕЗАВИСИМЫЙ сервис. Его настройки НЕ зависят от стенда.
+
+**Было**:
+```
+profile.env → REGISTRY_HOST, REGISTRY_HOSTNAME, S3_BUCKET, S3CFG_REGISTRY
+build-provider.sh → хардкод дефолтов
+docs-generator → хардкод provider-source
+```
+
+**Стало**:
+```
+registry.env (НОВЫЙ) → REGISTRY_HOSTNAME, S3_BUCKET, S3_ENDPOINT
+profile.env → только стенд-специфика: API, токен, namespace, версия
+скрипты → source registry.env + profile.env → всё из конфигов, ноль хардкода
+```
+
+## Принятые решения
+
+1. **Создать `TOOLS/config/registry.env`** — единый источник правды о реестре
+2. **Очистить `profile.env`** — убрать все registry-параметры
+3. **`02_generate...v2.sh`** — добавить `-provider-source` в вызов docs-generator
+4. **`build-provider.sh`** — заменить старый дефолт на актуальный
+5. **`main.go`** — fallback namespace: `nubes-test` → `nubes-dev`
+6. **`tf_registry/server/build-provider.sh`** — синхронизировать после правок
+7. **Креды S3** — НЕ в registry.env, только через env-переменные (безопасность)
+8. **docs-generator** — дефолт не трогаем, скрипт всегда передаёт явный `-provider-source`