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:
./install.sh --non-interactive
С внешним source-config:
./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.
Установка выполняется в две фазы
PHASE 0 — READ ONLY выполняет install.sh
проверка прав и checksums пакета
clean-host preflight из распакованного архива
↓ ноль изменений на сервере
↓ exec
PHASE 1 — MUTATION выполняет orchestrator
раскладка orchestrator и runtime-пакета
установка
install.sh не изменяет на сервере ничего: он проверяет и передаёт управление.
Всю мутирующую фазу выполняет оркестратор, поэтому при любом отказе известно,
какие именно пути были созданы этой операцией.
HY2XS v1 не устанавливается поверх предыдущей установки и не мигрирует её состояние. Если PHASE 0 обнаружит старую установку, установщик завершится с ошибкой и не изменит на сервере ничего.
Проверить хост, ничего не устанавливая:
./orchestrator/hy2xs-orchestrator preflight-install --package-dir "$(pwd)"
Очистка предыдущей установки — отдельная явная операция оператора, она описана
в docs/operations/14-legacy-cleanup.md репозитория проекта и выполняется скриптом
tools/legacy/purge-v0.sh. Установщик её никогда не запускает сам.