fix28: обновлена production-документация и упаковка docs в deb

This commit is contained in:
2026-05-12 16:56:36 +05:00
parent a9bac8fdad
commit 69c737bcf4
10 changed files with 488 additions and 150 deletions
+33 -16
View File
@@ -1,23 +1,40 @@
# awg2-reboot-scheduler
`awg2-reboot-scheduler` — production auxiliary binary в составе пакета AWG2 Harness.
`awg2-reboot-scheduler` — отдельный production-бинарь в составе пакета AWG2 Harness. Его задача узкая: один раз на старте прочитать секцию `[reboot]` из общего `/etc/awg2-harness/config.toml`, выбрать случайный момент внутри заданного UTC-окна, записать план в `/run/awg2-harness/reboot.plan` и в назначенное время запросить reboot через `systemctl --no-block reboot`.
Он читает общий конфиг [`/etc/awg2-harness/config.toml`](../config.example.toml), выбирает случайный момент в окне reboot и запрашивает перезагрузку через `systemctl --no-block reboot`.
Он вынесен отдельно от основного `awg2-harness daemon`, чтобы плановый reboot не зависел от traffic/firewall reconciliation loop.
## Production model
## Runtime paths
- binary: `/usr/sbin/awg2-reboot-scheduler`
- unit: [`/lib/systemd/system/awg2-reboot-scheduler.service`](../awg2-reboot-scheduler.service)
- config: `/etc/awg2-harness/config.toml`
- runtime plan file: `/run/awg2-harness/reboot.plan`
Сервис ставится и управляется общим packaging flow [`tools/build.sh`](../tools/build.sh), вручную в `/opt/...` ничего не раскладывается.
## Проверка на host
```bash
awg2-reboot-scheduler --config /etc/awg2-harness/config.toml
systemctl status awg2-reboot-scheduler
journalctl -u awg2-reboot-scheduler -f
```text
binary: /usr/sbin/awg2-reboot-scheduler
unit: /lib/systemd/system/awg2-reboot-scheduler.service
config: /etc/awg2-harness/config.toml
plan file: /run/awg2-harness/reboot.plan
```
## Конфигурация
```toml
[reboot]
enabled = true
window_start_utc = "01:00"
window_end_utc = "02:00"
```
Если `enabled = false`, процесс печатает `disabled by config` и завершается без reboot.
## Проверка на production host
```bash
systemctl status awg2-reboot-scheduler.service --no-pager -l
journalctl -u awg2-reboot-scheduler.service --since '10 minutes ago' --no-pager
cat /run/awg2-harness/reboot.plan
awg2-harness --config /etc/awg2-harness/config.toml status
```
## Ручной запуск для диагностики
```bash
/usr/sbin/awg2-reboot-scheduler --config /etc/awg2-harness/config.toml
```