Add infrastructure roadmap
This commit is contained in:
+102
@@ -0,0 +1,102 @@
|
|||||||
|
# Roadmap
|
||||||
|
|
||||||
|
Планируемые улучшения инфраструктурного репозитория. Файл фиксирует будущие работы, эксплуатационные риски и технический долг.
|
||||||
|
|
||||||
|
`CHANGELOG.md` описывает уже сделанные изменения, а этот файл хранит то, что еще нужно спланировать или выполнить.
|
||||||
|
|
||||||
|
## Высокий приоритет
|
||||||
|
|
||||||
|
### Обновить Nextcloud с EOL-версии
|
||||||
|
|
||||||
|
- Текущая версия: `nextcloud:30.0.6`.
|
||||||
|
- Риск: ветка Nextcloud 30 достигла EOL и не получает исправления безопасности.
|
||||||
|
- Что сделать:
|
||||||
|
- изучить upgrade path и release notes Nextcloud;
|
||||||
|
- сделать backup `data/nextcloud/`;
|
||||||
|
- проверить совместимость используемых apps;
|
||||||
|
- обновляться по поддерживаемому пути между major versions;
|
||||||
|
- после обновления проверить web UI, `occ status`, фоновые задачи и healthcheck.
|
||||||
|
|
||||||
|
### Обновить Gitea из-за security advisory
|
||||||
|
|
||||||
|
- Текущая версия: `docker.gitea.com/gitea:1.26.2`.
|
||||||
|
- Риск: для Gitea `<= 1.26.4` опубликован SSRF advisory, patched version указана как `1.27.0`.
|
||||||
|
- Что сделать:
|
||||||
|
- изучить release notes Gitea `1.27.0+`;
|
||||||
|
- сделать backup `data/gitea/`;
|
||||||
|
- обновить image version в `docker-compose.yml`;
|
||||||
|
- проверить web UI, git clone/push, Actions и healthcheck.
|
||||||
|
|
||||||
|
### Переделать backup перед деплоем
|
||||||
|
|
||||||
|
- Текущее поведение: workflow архивирует весь `data/` в `backups/` на том же диске.
|
||||||
|
- Риск: backup может падать из-за нехватки места до начала деплоя.
|
||||||
|
- Что сделать:
|
||||||
|
- добавить preflight-проверку свободного места;
|
||||||
|
- чистить старые backups до создания нового архива;
|
||||||
|
- рассмотреть backup только затронутого service data вместо всего `data/`;
|
||||||
|
- рассмотреть off-host backup или streaming backup на другую машину;
|
||||||
|
- документировать ручной backup/restore для отдельных сервисов.
|
||||||
|
|
||||||
|
## Средний приоритет
|
||||||
|
|
||||||
|
### Закрепить оставшиеся Docker image versions
|
||||||
|
|
||||||
|
- Сейчас floating images остаются у:
|
||||||
|
- `henrygd/beszel`;
|
||||||
|
- `henrygd/beszel-agent`;
|
||||||
|
- `gitea/act_runner:latest`;
|
||||||
|
- `rustdesk/rustdesk-server:latest`.
|
||||||
|
- Риск: деплой может неожиданно подтянуть несовместимую версию или, наоборот, не обновиться предсказуемо.
|
||||||
|
- Что сделать:
|
||||||
|
- подобрать актуальные стабильные версии;
|
||||||
|
- закрепить tags в `docker-compose.yml`;
|
||||||
|
- обновить `README.md` и `CHANGELOG.md`;
|
||||||
|
- для stateful-сервисов делать отдельные коммиты и backup перед деплоем.
|
||||||
|
|
||||||
|
### Пересмотреть безопасность Gitea Actions runner
|
||||||
|
|
||||||
|
- Текущее поведение: `git-runner` имеет доступ к `/var/run/docker.sock`.
|
||||||
|
- Риск: доступ к Docker socket фактически дает workflow root-equivalent доступ к хосту.
|
||||||
|
- Что сделать:
|
||||||
|
- явно определить trust boundary для Actions;
|
||||||
|
- ограничить запуск workflow только доверенными репозиториями/пользователями;
|
||||||
|
- рассмотреть отдельный runner host или VM;
|
||||||
|
- рассмотреть rootless/isolated runner setup, если это совместимо с нужными jobs.
|
||||||
|
|
||||||
|
### Уйти от password-based SSH deploy
|
||||||
|
|
||||||
|
- Текущее поведение: workflow использует `sshpass` и `sudo -S`.
|
||||||
|
- Риск: парольный deploy хуже аудируется и более хрупкий, чем key-based доступ с ограниченными правами.
|
||||||
|
- Что сделать:
|
||||||
|
- завести отдельного deploy user;
|
||||||
|
- перейти на SSH key;
|
||||||
|
- ограничить sudoers только нужными командами;
|
||||||
|
- убрать передачу sudo password из workflow.
|
||||||
|
|
||||||
|
## Низкий приоритет
|
||||||
|
|
||||||
|
### Добавить healthcheck для сервисов без проверки готовности
|
||||||
|
|
||||||
|
- Кандидаты:
|
||||||
|
- `pwd`;
|
||||||
|
- `sup-hbbs`;
|
||||||
|
- `sup-hbbr`.
|
||||||
|
- Цель: после деплоя видеть, что сервис не просто запущен, а реально отвечает.
|
||||||
|
|
||||||
|
### Почистить test Telegram workflow
|
||||||
|
|
||||||
|
- В `test_telegram_deploy_bot.yaml` есть неиспользуемая переменная `MESSAGE`, которая ссылается на несуществующий `steps.prepare_message`.
|
||||||
|
- Риск низкий: workflow сейчас не использует эту переменную, но она путает чтение и сопровождение.
|
||||||
|
|
||||||
|
### Разобраться с использованием диска
|
||||||
|
|
||||||
|
- После неудачной попытки backup занятое место на диске выросло.
|
||||||
|
- Первичные наблюдения:
|
||||||
|
- `backups/` не содержит крупного архива;
|
||||||
|
- `lsof +L1` не показал большого удаленного файла;
|
||||||
|
- Docker images занимают заметный объем, но не должны были измениться, если workflow упал до Docker-шагов.
|
||||||
|
- Что сделать:
|
||||||
|
- найти крупные каталоги через `du -xhd 1`;
|
||||||
|
- проверить `/var`, `/tmp`, Docker storage и filesystem reserve;
|
||||||
|
- только после диагностики решать, что можно чистить.
|
||||||
Reference in New Issue
Block a user