Эксплуатация
Этот раздел — для тех, кто обслуживает инстанс: его суперпользователей и тех, у кого есть root на его
серверах.
- Обновления: новые версии сервисов, агента ноды и CLI, с откатами.
- Бэкапы и восстановление: хранилища, планы, учения и восстановление всего инстанса.
- Ноды: серверы для приложений, edge и relay, квоты, переезд и удаление нод.
- Люди, команды и лимиты: приглашения, суперпользователи, планы, восстановление доступа.
- Внешний вид и брендинг: имя, цвета, логотип и фон инстанса; white-label сборки.
- Безопасность: что защищать, где лежат секреты, как укрепить серверы.
- Решение проблем: симптомы, куда смотреть и какие команды это покажут.
Прежде чем менять production
- Определите, какой сервис, приложение, ноду и данные затрагивает действие, и сначала посмотрите их текущее
состояние.
- Делайте бэкап перед миграциями, восстановлением и удалением всего, что нельзя пересоздать.
- Откат образа — не откат данных: миграция схемы остаётся, когда возвращается старый код.
- Держите предыдущий живой релиз, пока замена не стала здоровой.
- Не вставляйте логи с учётными данными в тикеты: env-файлы, строки подключения к базам, OAuth-колбэки,
токены реестров и ключи запечатывания — это не диагностика.
Что где работает
| Сервер |
Что запущено |
| control plane |
PostgreSQL, Caddy, xvii-node, все сервисы платформы (xvii-<service>.service) |
| ноды |
xvii-node как агент, Docker, сети команд и контейнеры приложений |
| серверы имён |
xvii-node dns, отвечающий на порту 53 (любые два сервера) |
| почтовый edge |
xvii-node edge, перенаправляющий почтовые порты (по желанию) |
Состояние control plane хранится в PostgreSQL (по базе на сервис) и в /etc/xvii и /var/lib/xvii. Раскладку
см. в Конфигурации.
Повседневные команды на control plane
xvii-node status # сервисы, версии, здоровье
xvii-node logs pages 200 # журнал сервиса
xvii-node install pages # поставить или обновить из хранилища
xvii-node recover alice # ссылка для входа тому, кто потерял доступ
systemctl status xvii-node
journalctl -u xvii-apps -n 50 --no-pager