doc: HOWTO-UPLOAD.md — схема версий (2=PROD, 3=DEV, 5=TEST) + VERSIONS.md для трекинга

HOWTO-UPLOAD.md

@@ -1,4 +1,16 @@
-# Как залить провайдер в реестр (ПРОД)
+# Как залить провайдер в реестр
+
+## ⛔ Схема версий
+
+**Первая цифра версии жёстко привязана к стенду. НЕ ПУТАТЬ.**
+
+| Стенд | Namespace | Версия | Первая цифра |
+|---|---|---|---|
+| **PROD** | `nubes` | `2.x` | `2.*` |
+| **DEV** | `nubes-dev` | `3.x` | `3.*` |
+| **TEST** | `nubes-test` | `5.x` | `5.*` |
+
+Пример: `3.0.1` — DEV. `5.1.17` — TEST. `2.1.23` — PROD.
 
 ## Конфигурация
 
@@ -54,8 +66,18 @@ mc alias set prod-s3 https://s3.msk-1.ngcloud.ru L9F0R8CYYKYIUW180203 yJlgxoKsRB
 export S3_ACCESS_KEY=L9F0R8CYYKYIUW180203
 export S3_SECRET_KEY=yJlgxoKsRBwCtJQh57Z0nwo5EBDYmyBNDDhG6NKw
 
-# 3. Запуск (всё остальное — дефолты скрипта)
+# 3. Заливка (NAMESPACE + VERSION)
+# DEV:
+export NAMESPACE=nubes-dev
+bash ~/tf_registry/server/build-provider.sh 3.0.1
+
+# TEST:
+export NAMESPACE=nubes-test
 bash ~/tf_registry/server/build-provider.sh 5.1.17
+
+# PROD:
+export NAMESPACE=nubes
+bash ~/tf_registry/server/build-provider.sh 2.1.23
 ```
 
 Дефолты скрипта (можно переопределить через env):
@@ -76,10 +98,24 @@ bash ~/tf_registry/server/build-provider.sh 5.1.17
 ## Проверка после заливки
 
 ```bash
-curl https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes-test/nubes/versions
+# DEV
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes-dev/nubes/versions | python3 -m json.tool
+
+# TEST
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes-test/nubes/versions | python3 -m json.tool
+
+# PROD
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes/nubes/versions | python3 -m json.tool
+
+# Smoke-тест
 bash ~/tf_registry/tests/smoke.sh https://tf-registry.containerk8s.services.ngcloud.ru
 ```
 
+## Актуальные версии
+
+Файл [`VERSIONS.md`](VERSIONS.md) — единственный источник правды о том, что залито на каждом стенде.
+После каждой заливки — обновить `VERSIONS.md`.
+
 ## Namespace'ы
 
 | Namespace | Назначение |

VERSIONS.md

@@ -0,0 +1,30 @@
+# Версии провайдера по стендам
+
+> Обновлять после **каждой** заливки. Это единственный источник правды.
+
+| Стенд | Namespace | Версия | Дата заливки |
+|---|---|---|---|
+| DEV | `nubes-dev` | `3.0.1` | 2026-08-09 |
+| TEST | `nubes-test` | `5.1.17` | 2026-08-09 |
+| PROD | `nubes` | — | — |
+
+## Как проверить
+
+```bash
+# DEV
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes-dev/nubes/versions | python3 -m json.tool
+
+# TEST
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes-test/nubes/versions | python3 -m json.tool
+
+# PROD
+curl -s https://tf-registry.containerk8s.services.ngcloud.ru/v1/providers/nubes/nubes/versions | python3 -m json.tool
+```
+
+## Схема версионирования
+
+| Стенд | Первая цифра |
+|---|---|
+| PROD | `2.*` |
+| DEV | `3.*` |
+| TEST | `5.*` |