From 96594fae249ca40db9b53ff848a98166026fbb67 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Sun, 9 Aug 2026 15:14:59 +0400
Subject: [PATCH] =?UTF-8?q?doc:=20HOWTO-UPLOAD.md=20=E2=80=94=20=D1=81?=
 =?UTF-8?q?=D1=85=D0=B5=D0=BC=D0=B0=20=D0=B2=D0=B5=D1=80=D1=81=D0=B8=D0=B9?=
 =?UTF-8?q?=20(2=3DPROD,=203=3DDEV,=205=3DTEST)=20+=20VERSIONS.md=20=D0=B4?=
 =?UTF-8?q?=D0=BB=D1=8F=20=D1=82=D1=80=D0=B5=D0=BA=D0=B8=D0=BD=D0=B3=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 HOWTO-UPLOAD.md | 42 +++++++++++++++++++++++++++++++++++++++---
 VERSIONS.md     | 30 ++++++++++++++++++++++++++++++
 2 files changed, 69 insertions(+), 3 deletions(-)
 create mode 100644 VERSIONS.md

diff --git a/HOWTO-UPLOAD.md b/HOWTO-UPLOAD.md
index 2f2e5f7..d6b6f2d 100644
--- a/HOWTO-UPLOAD.md
+++ b/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 | Назначение |
diff --git a/VERSIONS.md b/VERSIONS.md
new file mode 100644
index 0000000..0a35f9b
--- /dev/null
+++ b/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.*` |