Files
AWatch-rus/docs/wiki/Server-Infrastructure.md
T

72 lines
3.0 KiB
Markdown

# Server Infrastructure
## 2.2 Local state retention
Коммит `cc9e4a0` добавил отдельный server-side maintenance path для контроля роста локального state на AW server.
## `aw-prune-local-state.sh`
Скрипт `aw-server/aw-prune-local-state.sh` устанавливается в:
```text
/usr/local/bin/aw-prune-local-state.sh
```
Назначение:
- чистит старые backup-файлы в `{{ aw_server_data_dir }}/backups`;
- отдельно удерживает последние DB backups и JSON backups;
- удаляет временные архивы из `/tmp`: `activitywatch-*.zip`, `hayabusa-*.zip`, `aw-hayabusa-profiles.txt`;
- удаляет временные WebUI/worktime artifacts старше одного дня: `aw-worktime-ui-bridge.py`, `views-default.json`, `apply_webui_ru_patch.out`.
## systemd unit и timer
Ansible создает:
```text
/etc/systemd/system/aw-prune-local-state.service
/etc/systemd/system/aw-prune-local-state.timer
```
Timer:
```ini
[Timer]
OnCalendar=*-*-* 04:40:00
Persistent=true
```
То есть очистка запускается ежедневно в `04:40`; если хост был выключен, `Persistent=true` догонит пропущенный запуск.
## Retention-параметры
Параметры задаются в `ansible/group_vars/aw_server.yml`:
| Переменная | Значение по умолчанию | Назначение |
| --- | ---: | --- |
| `aw_server_backup_retention_days` | `7` | Возраст backup-файлов, после которого они могут быть удалены. |
| `aw_server_backup_keep_last_db` | `2` | Минимум последних DB backup'ов, которые всегда сохраняются. |
| `aw_server_backup_keep_last_json` | `2` | Минимум последних JSON backup'ов, которые всегда сохраняются. |
| `aw_server_journal_system_max_use` | `100M` | Лимит persistent journald storage. |
| `aw_server_journal_runtime_max_use` | `50M` | Лимит runtime journald storage. |
| `aw_server_journal_system_keep_free` | `500M` | Минимально свободное место, которое journald должен оставить на FS. |
## journald retention
`deploy_aw_server.yml` устанавливает drop-in:
```text
/etc/systemd/journald.conf.d/aw-rus-retention.conf
```
Содержимое управляется Ansible:
```ini
[Journal]
SystemMaxUse={{ aw_server_journal_system_max_use }}
RuntimeMaxUse={{ aw_server_journal_runtime_max_use }}
SystemKeepFree={{ aw_server_journal_system_keep_free }}
```
После изменения drop-in playbook перезапускает `systemd-journald` и выполняет `journalctl --vacuum-size={{ aw_server_journal_system_max_use }}`. Это ограничивает рост логов без ручной очистки и снижает риск заполнения rootfs на AW server.