forked from mtusi2026/mtusi2026lab4
35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
# Перенесённая основа lab3
|
||
|
||
На этом этапе перенесена только работающая основа: FastAPI, PostgreSQL,
|
||
миграции 001–003, сессии и кеш Redis, идемпотентность сообщений, две API-реплики
|
||
и Nginx с проверкой готовности. S3 и вложения ещё не реализованы.
|
||
Контракт и публичные тесты остаются от lab4; полный smoke lab4 пока не пройдёт.
|
||
|
||
## Запуск основы
|
||
|
||
Скопируйте `.env.example` в `.env` и задайте свой `POSTGRES_PASSWORD`.
|
||
Параметры `*_FILE` и S3 пока являются настройками будущей реализации;
|
||
текущая основа использует `POSTGRES_*` и Redis из Compose.
|
||
|
||
```sh
|
||
docker compose --env-file .env config --quiet
|
||
docker compose --env-file .env up -d --build
|
||
```
|
||
|
||
API доступен через http://localhost:8080. При одновременно запущенной lab3
|
||
укажите другой `APP_PORT` в `.env`. Имя образа lab4 отдельное, volumes
|
||
изолируются именем Compose-проекта. Миграции выполняет сервис `migrate`.
|
||
|
||
Проверка перенесённой логики после запуска:
|
||
|
||
```sh
|
||
docker compose exec -T api python -m unittest discover -s student-tests -v
|
||
```
|
||
|
||
В `student-tests` перенесены проверки базового API/сессий и идемпотентности.
|
||
Эксперименты масштабирования, старые результаты и отчёт lab3 не переносились.
|
||
Скрипты `scripts/restart.*` и `scripts/stop-one.*` работают с текущим проектом;
|
||
для остановки реплики требуется `TARGET_INSTANCE_ID` из `X-Instance-Id`.
|
||
При добавлении S3 потребуется включить его в сценарий перезапуска и адаптировать
|
||
лимиты тела запроса в API и Nginx для загрузки изображений.
|