обновила отчет

This commit is contained in:
vasyukova
2026-09-30 23:57:43 +03:00
parent e9553e33d6
commit 024f8d7649
+43 -20
View File
@@ -1,44 +1,67 @@
# Отчёт — лабораторная 2
- Автор, группа: Васюкова Наталья, БВТ2303
- Целевая оценка: 5
- Целевая оценка: 3
- Commit/PR: solution/BVT2303-Vasyukova
- Использованные источники, библиотеки и помощь ИИ:
- Контракт: contracts/openapi.json, contracts/README.md
- Инструкции: README.md, COURSE.md, CONTRIBUTING.md
- Библиотеки: fastapi==0.115.0, uvicorn[standard]==0.32.0, pydantic (из fastapi)
- Библиотеки: fastapi==0.115.0, uvicorn[standard]==0.32.0, psycopg[binary]==3.2.3, pydantic (из fastapi)
- ИИ: DeepSeek — помощь в структурировании кода и отчёта. Весь код проверен, отредактирован и запущен разработчиком.
## Запуск из чистого clone
Версии runtime/образов и Prerequisites (предварительные требования):
- Python: 3.12 (базовый образ python:3.12-slim)
- FastAPI 0.115.0, uvicorn[standard] 0.32.0
- Docker Desktop (Windows), образ mtusi-messenger:lab1
- Git
- FastAPI 0.115.0, uvicorn[standard] 0.32.0, psycopg[binary] 3.2.3
- PostgreSQL 18.6
- Docker Desktop (Windows), образ mtusi-messenger:lab2
Шаги:
1. git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab1.git && cd mtusi2026lab1
2. git checkout solution/BVT2303-Vasyukova
3. Создать локального secrets из шаблона:
### Подготовка PostgreSQL
1. Установить PostgreSQL 18.6, открыть pgAdmin, подключиться к серверу localhost:5432 под пользователем postgres.
2. Создать БД:
- Database: `high_load_messenger`
- Owner: `postgres`
3. В Query Tool для базы high_load_messenger создать роль приложения:
```sql
CREATE ROLE messenger WITH LOGIN PASSWORD 'messenger';
GRANT ALL PRIVILEGES ON DATABASE high_load_messenger TO messenger;
GRANT ALL ON SCHEMA public TO messenger;
```
4. Схему таблиц автоматически создает приложение на старте.
### Запуск API
1. Клонировать репозиторий:
```
git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab2.git && cd mtusi2026lab2
```
2. Переключиться на ветку решения:
```
git checkout solution/BVT2303-Vasyukova
```
3. Создать локальный `.env` из шаблона:
```
copy .env.example .env
(значения по умолчанию: APP_HOST=0.0.0.0, APP_PORT=8080, APP_ENV=lab)
```
Отредактировать `.env`, указав DATABASE_URL.
4. Сборка образа:
docker build -t mtusi-messenger:lab1 .
```
docker build -t mtusi-messenger:lab2 .
```
5. Запуск:
docker run --rm --name mtusi-messenger-lab1 -p 127.0.0.1:8080:8080 --env-file .env mtusi-messenger:lab1
```
docker run --rm --name mtuci-messenger-lab2 -p 127.0.0.1:8080:8080 --env-file .env --add-host=host.docker.internal:host-gateway mtuci-messenger:lab2
```
Флаг `--add-host=host.docker.internal:host-gateway` обязателен, если PostgreSQL работает на хосте, а не в контейнере.
6. Проверка готовности:
```
curl.exe -s http://localhost:8080/health/ready
Ожидается: {"status":"ok"}
```
Ожидается: `{"status":"ok"}`.
7. Публичный smoke (в другом терминале):
python tests/smoke.py --base-url http://localhost:8080
8. Собственные тесты уровня 4 (в другом терминале):
python student-tests/run_all.py --base-url http://localhost:8080
9. Остановка и удаление учебных данных:
Ctrl+C в терминале контейнера
Или:
docker stop mtusi-messenger-lab1
Данные исчезают при остановке контейнера (флаг --rm - удалить сам контейнер).
Альтернативный локальный запуск без Docker:
python -m uvicorn src.app.main:app --host 0.0.0.0 --port 8080 --reload