62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
# HY2XS install package
|
||
|
||
Этот пакет создаётся production builder'ом на Debian 13 amd64.
|
||
|
||
Пакет предназначен для чистого Debian 13 target и содержит:
|
||
|
||
- compiled install-only orchestrator;
|
||
- bundled HY2XS admin;
|
||
- templates;
|
||
- systemd units;
|
||
- package metadata и checksums.
|
||
|
||
Запускать от root:
|
||
|
||
```sh
|
||
./install.sh --non-interactive
|
||
```
|
||
|
||
С внешним source-config:
|
||
|
||
```sh
|
||
./install.sh --config /root/custom-hy2xs.env --non-interactive
|
||
```
|
||
|
||
Файл конфигурации обязан быть корректным UTF-8 без BOM/U+FEFF, NUL,
|
||
суррогатов и Unicode noncharacters. Установщик читает исходные байты строго и
|
||
отвергает повреждение на read-only preflight: молчаливой замены на U+FFFD и
|
||
изменений хоста при таком отказе нет.
|
||
|
||
В baseline нет target-side JavaScript, TypeScript, frontend или Go build step.
|
||
|
||
## Установка выполняется в две фазы
|
||
|
||
```text
|
||
PHASE 0 — READ ONLY выполняет install.sh
|
||
проверка прав и checksums пакета
|
||
clean-host preflight из распакованного архива
|
||
↓ ноль изменений на сервере
|
||
↓ exec
|
||
PHASE 1 — MUTATION выполняет orchestrator
|
||
раскладка orchestrator и runtime-пакета
|
||
установка
|
||
```
|
||
|
||
`install.sh` не изменяет на сервере ничего: он проверяет и передаёт управление.
|
||
Всю мутирующую фазу выполняет оркестратор, поэтому при любом отказе известно,
|
||
какие именно пути были созданы этой операцией.
|
||
|
||
HY2XS v1 **не устанавливается поверх** предыдущей установки и не мигрирует её
|
||
состояние. Если PHASE 0 обнаружит старую установку, установщик завершится с
|
||
ошибкой и **не изменит на сервере ничего**.
|
||
|
||
Проверить хост, ничего не устанавливая:
|
||
|
||
```sh
|
||
./orchestrator/hy2xs-orchestrator preflight-install --package-dir "$(pwd)"
|
||
```
|
||
|
||
Очистка предыдущей установки — отдельная явная операция оператора, она описана
|
||
в `docs/operations/14-legacy-cleanup.md` репозитория проекта и выполняется скриптом
|
||
`tools/legacy/purge-v0.sh`. Установщик её никогда не запускает сам.
|