Полная миграция baseline на Debian 13: build-layer, metadata и документация

2026-05-05 05:39:59 +05:00
parent 52f1e5d909
commit 9368846405
12 changed files with 37 additions and 35 deletions
@@ -21,7 +21,7 @@
 Builder layer **не разворачивается на сервере**.

 ### 2. Runtime / target layer
-Запускается **только на чистом Debian 12**.
+Запускается **только на чистом Debian 13**.

 Функции:
 - установка системных зависимостей
@@ -100,7 +100,7 @@ Telegram-бот, backend выдачи ключей, remote profile publishing, b
 5. Bun/TypeScript install-only orchestrator
 6. systemd + nftables
 7. post-install env
-8. install-only flow под чистый Debian 12
+8. install-only flow под чистый Debian 13

 ## Что не входит в baseline

@@ -122,7 +122,7 @@ Telegram-бот, backend выдачи ключей, remote profile publishing, b

 1. На локальной машине собирается install package.
 2. В пакет уже встроены наш HY2XS admin и install-артефакт оркестратора.
-3. Пакет переносится на чистый Debian 12.
+3. Пакет переносится на чистый Debian 13.
 4. На сервере запускается только install-only orchestration.
 5. Сервер скачивает свежую Hysteria2 из official upstream.
 6. Сервер разворачивает bundled UI из пакета.
@@ -19,12 +19,12 @@
 ## Где работает builder

 Production builder работает на отдельном build host:
- Debian 12
+- Debian 13
 - amd64 / x86_64
 - bash
 - доступ к интернету для apt и скачивания toolchain

-В текущей production-модели сборка выполняется **на Debian 12 amd64**, а не на Windows/macOS dev-машине.
+В текущей production-модели сборка выполняется **на Debian 13 amd64**, а не на Windows/macOS dev-машине.

 Builder не является частью target install flow: на target server приезжает уже готовый install package, без JS/TS/Go build step.

@@ -104,7 +104,7 @@ project/

 ## Production builder bootstrap

-`tools/build/build.sh` должен быть самодостаточным для Debian 12 amd64:
+`tools/build/build.sh` должен быть самодостаточным для Debian 13 amd64:

 1. Проверяет ОС и архитектуру.
 2. Проверяет структуру репозитория и lock-файлы.
@@ -132,8 +132,8 @@ project/

 Система считается правильной, если:

-1. builder запускается на Debian 12 amd64 build host, не как target-side build step
-2. пакет можно перенести на чистый Debian 12
+1. builder запускается на Debian 13 amd64 build host, не как target-side build step
+2. пакет можно перенести на чистый Debian 13
 3. на сервере нет отдельного build step
 4. bundled UI уже находится внутри пакета
 5. оркестратор authored as Bun/TypeScript, но на target приходит как готовый install-артефакт
@@ -28,7 +28,7 @@ Hysteria2 — основной транспортный компонент се

 ## Платформа

- ОС: только Debian 12
+- ОС: только Debian 13
 - init/system management: systemd
 - сетевой фильтр: nftables
 - архитектура baseline: x86_64/amd64
@@ -41,7 +41,7 @@
 ## Предусловия

 Оркестратор рассчитан только на:
- чистый Debian 12
+- чистый Debian 13
 - root/sudo install context
 - один сервер
 - одну baseline-схему
@@ -74,7 +74,7 @@

 ## Что делает оркестратор по шагам

-1. Проверяет, что ОС — Debian 12.
+1. Проверяет, что ОС — Debian 13.
 2. Проверяет базовые зависимости и install context.
 3. Создаёт каталоги установки.
 4. Разворачивает bundled HY2XS admin.
@@ -7,7 +7,7 @@
 ## A. Builder layer tests

 ### Проверяем
-1. builder запускается на Debian 12 amd64 build host
+1. builder запускается на Debian 13 amd64 build host
 2. итоговый пакет собирается без target-side шагов
 3. bundled HY2XS admin реально входит в пакет
 4. package metadata / build id присутствуют
@@ -19,7 +19,7 @@

 ## B. Target install tests

-### На чистом Debian 12 проверяем
+### На чистом Debian 13 проверяем
 1. пакет запускается без ручной сборки на сервере
 2. Hysteria2 скачивается с official upstream
 3. bundled HY2XS admin раскладывается локально из пакета
@@ -58,7 +58,7 @@

 ## D. Negative tests

-1. не Debian 12
+1. не Debian 13
 2. порт уже занят
 3. старое конфликтующее состояние уже существует
 4. домен / SNI заданы некорректно
@@ -73,7 +73,7 @@

 Система принимается, если:

-1. production builder на Debian 12 amd64 выдаёт переносимый install package
+1. production builder на Debian 13 amd64 выдаёт переносимый install package
 2. target server не выполняет build step
 3. Hysteria2 получена из official upstream
 4. UI поставлен из bundled fork
@@ -2,7 +2,7 @@

 ## 1. Supported target

- clean Debian 12 amd64
+- clean Debian 13 amd64
 - single host install profile
 - IPv4-only runtime model

@@ -4,7 +4,7 @@

 - серверный транспорт: **ванильная Hysteria2**
 - UI: **наш форк H UI / HY2XS admin**, поставляется **вместе с проектом**
- target OS: **только чистый Debian 12**
+- target OS: **только чистый Debian 13**
 - оркестратор: **install-only**, только первичная установка и базовая настройка
 - стек оркестратора: **Bun + TypeScript**
 - target-side build: **запрещён**
@@ -17,10 +17,10 @@

 В этой редакции зафиксированы два слоя:

-1. **Builder layer** — работает на отдельном **Debian 12 amd64 build host**.
+1. **Builder layer** — работает на отдельном **Debian 13 amd64 build host**.
   Он собирает итоговый пакет, подготавливает **наш форк HY2XS admin**, компилирует **Bun/TypeScript оркестратор** в install-артефакт, упаковывает шаблоны, unit-файлы и примеры конфигов.

-2. **Runtime / target layer** — работает **на чистом Debian 12**.
+2. **Runtime / target layer** — работает **на чистом Debian 13**.
   Здесь нет сборщика. Здесь запускается только итоговый install package / orchestrator, который:
   - ставит системные зависимости
   - разворачивает **наш встроенный UI**
@@ -72,4 +72,4 @@

 Правильная baseline-модель теперь такая:

-**Локальный builder собирает install package с нашим форком HY2XS admin и Bun/TypeScript оркестратором; серверный install-only orchestrator ставит этот пакет на чистый Debian 12, тянет свежую Hysteria2 из upstream, разворачивает UI, создаёт systemd + nftables + post-install env и подготавливает рабочее серверное окружение.**
+**Локальный builder собирает install package с нашим форком HY2XS admin и Bun/TypeScript оркестратором; серверный install-only orchestrator ставит этот пакет на чистый Debian 13, тянет свежую Hysteria2 из upstream, разворачивает UI, создаёт systemd + nftables + post-install env и подготавливает рабочее серверное окружение.**