forked from mtusi2026/mtusi2026lab3
42 lines
2.7 KiB
Markdown
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`.
|