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

42 lines
2.7 KiB
Markdown

# Запуск реализации
Каменский Андрей Игоревич, БПИ2301. Полный отчёт — [REPORT.md](REPORT.md), исследование — [RESEARCH.md](RESEARCH.md), дополнительные проверки — [CHECKS.md](CHECKS.md). README.md содержит исходное задание.
```sh
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](http://localhost:8081/docs).
Две API используют общие PostgreSQL и Redis, наружу опубликован только HAProxy. Миграции запускает отдельный сервис. Секреты — в игнорируемом .env; исходный .env.example задания сохранён.
```sh
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
```
Дополнительные инструменты:
```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, затем восстанавливают окружение. Новые данные синтетические.
```sh
docker compose build api
.venv/bin/python scripts/rolling-update.py
```
Новая реплика сначала проходит readiness и обнаружение LB; старая выводится в drain и останавливается. Миграции в rolling-скрипт не входят. При смене типов колонок в 005/006 требуется окно обслуживания; со старым образом новую схему смешивать нельзя.
Остановка без удаления данных: `docker compose down`. Намеренное полное удаление учебных данных: `docker compose down --volumes`.