Files
mtusi2026lab3/OPERATIONS.md
T
2026-11-02 20:05:33 +03:00

33 lines
2.6 KiB
Markdown

# Эксплуатация lab3
Основные команды и восстановление описаны в [GUIDE.md](GUIDE.md), параметры и границы —
в [REPORT.md](REPORT.md), демонстрация — в [DEFENSE.md](DEFENSE.md).
| Действие | Команда |
| --- | --- |
| Поднять | docker compose --env-file .env up -d --build |
| Дождаться двух API | python3 scripts/replicas.py restore |
| Контейнер, PID и alias | make replicas |
| Остановить выбранный alias | TARGET_INSTANCE_ID=alias scripts/stop-one.sh |
| Восстановить | make restore |
| Заменить по очереди | make rolling (образ предварительно собрать, миграции отдельно) |
| Полный restart без удаления данных | scripts/restart.sh |
| Собрать измерения | make lab3-evidence |
| Посмотреть upstream | docker compose --env-file .env exec nginx cat /tmp/backends.conf |
PostgreSQL — критическая зависимость: `/health/ready` и защищённые запросы дают 503
при недоступной БД; `/health/live` продолжает давать 200. Redis необязателен: при сбое
проверка идёт через PostgreSQL. Кэш не является источником решения о положительном
доступе. Перезапуск Redis не требует восстановления из backup, сессии лежат в pgdata.
При прерванной ручной замене в Nginx может остаться `/tmp/drain-api-a` или
`/tmp/drain-api-b`. `make restore` удаляет эти marker и поднимает обе API.
При недоступных обеих API Nginx остаётся жив и возвращает ошибку upstream; это не
успешная readiness. Restart policy не поднимает намеренно остановленную оператором
службу до явного start/up. `make restore` нужен перед следующим failover.
Не используйте `docker compose config` или полный `docker inspect` в evidence:
они содержат credentials из окружения. Сборщик выводит только config --quiet,
ограниченный inspect состояния/лимитов и безопасные логи Nginx. Токены и пароли
тестов остаются в памяти. Сбор evidence изменяет только синтетические учебные данные.