обновила отчет
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user