Files
mtusi2026lab3/IMPLEMENTATION.md
2026-11-06 18:57:43 +03:00

2.7 KiB

Запуск реализации

Каменский Андрей Игоревич, БПИ2301. Полный отчёт — REPORT.md, исследование — RESEARCH.md, дополнительные проверки — CHECKS.md. README.md содержит исходное задание.

cp compose.env.example .env
# Задать случайный hex POSTGRES_PASSWORD.
docker compose up -d --build --wait
make check test test-lab3

По умолчанию внешний порт 8080. Для совместной работы с предыдущим стендом указать APP_PORT=8081 в .env. Makefile определяет BASE_URL по конфигурации; его можно переопределить явно. В текущем локальном окружении выбран 8081: Swagger.

Две API используют общие PostgreSQL и Redis, наружу опубликован только HAProxy. Миграции запускает отдельный сервис. Секреты — в игнорируемом .env; исходный .env.example задания сохранён.

make test-failover ACTION_SCRIPT=scripts/stop-one.sh
# Восстановить остановленную API:
docker compose up -d --no-deps --wait api
make test-persistence ACTION_SCRIPT=scripts/restart.sh

Дополнительные инструменты:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make check validate lint PYTHON=.venv/bin/python
.venv/bin/python scripts/review-lab3.py

Инфраструктурные проверки выполнять последовательно на учебном стенде. Они останавливают контейнеры, временно изменяют схему или занимают освобождённые IP, затем восстанавливают окружение. Новые данные синтетические.

docker compose build api
.venv/bin/python scripts/rolling-update.py

Новая реплика сначала проходит readiness и обнаружение LB; старая выводится в drain и останавливается. Миграции в rolling-скрипт не входят. При смене типов колонок в 005/006 требуется окно обслуживания; со старым образом новую схему смешивать нельзя.

Остановка без удаления данных: docker compose down. Намеренное полное удаление учебных данных: docker compose down --volumes.