Эксплуатация и обслуживание¶

Процедуры второго дня для операторов. Доступность: оба издания, если не отмечено.

Обновление существующей установки¶

./update.sh

Сохраняет .env и дамп БД в backups/, помечает текущие образы как :rollback, пересобирает (исходники) или загружает образы (airgap-бандл), пересоздаёт контейнеры, не трогая volume, и ждёт health-check бэкенда. ./update.sh --rollback вернёт предыдущие образы; миграции БД не откатываются автоматически — при полном возврате восстановите дамп из backups/.

Старт / стоп / рестарт¶

docker compose up -d            # старт (также применяет изменения конфигурации)
docker compose restart backend  # рестарт одного сервиса
docker compose down             # стоп (volume с данными сохраняются)

Миграции Alembic выполняются автоматически при каждом старте бэкенда — в штатной работе отдельной команды миграций нет. Для разработки в backend/Makefile есть make db-status, db-upgrade, db-downgrade, db-new, db-history (требуют DATABASE_URL).

Health-проверки¶

curl -s http://localhost:3000/api/health        # связность БД + Redis
docker compose ps                               # состояния сервисов

В UI: System → Health (пул воркеров: running, active jobs, max workers; счётчики сущностей) и System → Metrics (totals, счётчики статусов задач). Вкладка Jobs показывает live-бейдж воркера (⚙ active/max +queue).

Логи¶

docker compose logs -f backend --tail 200

Структурированные логи приложения также доступны в UI: System → Logs (с фильтрами; GET /api/system/logs). DevOps Log (Admin → DevOps Log) записывает действия самой платформы — что Umbryx делал с инфраструктурой (EE-развёртывания, provisioning workstation) с фильтрами по stack/level/category.

Обновления¶

git pull                        # или docker compose pull для деплоя готовых образов
docker compose up -d --build

Миграции применяются при старте; задачи в статусе awaiting ROE approval переживают рестарт бэкенда
Сначала резервная копия — см. Резервное копирование и восстановление
Переходы EE↔Core — замена образа; схема общая

Изменение конфигурации¶

Правьте .env, затем docker compose up -d (контейнеры пересоздаются с новым окружением). Переменные с пометкой «без рестарта» в Справочнике конфигурации перечитываются на каждый запрос.

Redis / бэкенд воркеров¶

Штатному пулу internal допсервисы не нужны. Переключение на WORKER_BACKEND=arq требует включить compose-сервис worker; при недоступности arq-пула платформа откатывается на in-process исполнение.

Встроенные rate-limits¶

Вход 5/мин (+ блокировка аккаунта на 30 мин после 10 неудач при работающем Redis), экспорт отчётов 10/мин, инжест вебхуков 120/мин, reveal учётных данных 30/мин. Отключаются только при APP_ENV=test.