Развёртывание: от «запускается» до «можно доверить хостингу»

Обзор

42.1 Введение

Развёртывание приложения XServer не знает ни списка зависимостей, ни подготовки среды, ни шагов установки — всё это свёрнуто ещё в главе 2. Остаются лишь три эксплуатационных вопроса: где разместить (планировка), как держать резидентным (сервис-менеджер) и как красиво останавливать (корректная остановка + внешний тайм-аут). Глава разбирает их по очереди.

42.2 Поставка и рабочая планировка

/opt/www/                  /* корень развёртывания = каталог exe = каталог конфигурации */
├── xs                     /* единственный бинарник (компилятор/SDK/рантайм внутри) */
├── xs.json                /* главный конфиг: services + все vhost */
├── host/default/...       /* ферма сайтов (планировка гл. 20) */
├── host/xxdevs/...
├── tools/  dev/           /* эксплуатационные помощники и dev-копии */
└── (никаких иных зависимостей)

• Версионирование: весь каталог — одна единица; откат = вернуть прошлую копию каталога (xs.exe и исходники/конфиг всегда одной версии)
• Пути обновления: структурное изменение = скопировать в новый каталог и перезапустить; текущие правки = перезаписать файлы скриптов + reload (минутная дисциплина изменений, гл. 31)
• Изоляция данных: db/ лежит внутри каталога сайта — стратегия бэкапа делается по каталогам

42.3 Сервисное управление

Реальный скрипт запуска продакшна home (дословно из репозитория):

#!/bin/sh
case "${1}" in
  start)
    cd /opt/www
    sudo nohup /opt/www/xs /opt/www/xs.json &
    ;;
  stop)
    sudo pkill -9 -f /opt/www/xs        /* внимание: -9 жёсткое убийство */
    ;;
  restart)
    sudo pkill -9 -f /opt/www/xs
    cd /opt/www; sudo nohup /opt/www/xs /opt/www/xs.json &
    ;;
esac

Что только что произошло: скрипт показывает минимально жизнеспособную форму и обнажает точку роста — pkill -9 бьёт насмерть, минуя корректную остановку (пять фаз гл. 06). Рекомендуемая форма — юнит systemd, где сначала вежливо по умолчанию:

[Unit]
Description=xs application server
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/www
ExecStart=/opt/www/xs /opt/www/xs.json
/* корректная остановка: сперва SIGTERM со запасом времени, SIGKILL лишь по тайм-ауту */
KillSignal=SIGTERM
TimeoutStopSec=120
Restart=on-failure
RestartSec=3
/* вывод в journald; внутри приложения уровни — через xrtLogger */
StandardOutput=journal

[Install]
WantedBy=multi-user.target

Эквивалент на Windows: обёртка-служба (или назначенное задание + net stop, доставляющий сигнал группе процессов через CTRL_BREAK — именно этим занят инструмент wingrp из test.bat).

42.4 Дисциплина остановки

• Внутри: SIGTERM/Ctrl+C → пятифазная корректная остановка (гл. 06) — без принудительного демонтажа, длинные соединения ждут до конца
• Снаружи: подстраховку даёт сервис-менеджер — TimeoutStopSec у systemd, stopwaitsecs у supervisor. Сколько давать? Чуть больше самого длинного легального запроса (например, потолок отдачи больших файлов + буфер)
• Порядок: ритм прокатки «новый экземпляр готов → переключить трафик → SIGTERM старому → дождаться осушения → подстраховочный добой»

42.5 Контракт

• Каталог: корень развёртывания = exe = конфигурация; каталог версонируется целиком, откат — смена каталога.
• Сервис: резидентность у сервис-менеджера; Restart=on-failure — подстраховка от падений.
• Остановка: внутренняя корректность + внешний тайм-аут, одно без другого не живёт.

Частые ошибки

Упражнения