Files

2.7 KiB
Raw Permalink Blame History

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. Установщик её никогда не запускает сам.