From 024f8d76495bf5025912637f0bbbfd6df6d41781 Mon Sep 17 00:00:00 2001 From: vasyukova Date: Wed, 30 Sep 2026 23:57:43 +0300 Subject: [PATCH] =?UTF-8?q?=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=B0=20=D0=BE=D1=82=D1=87=D0=B5=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 63 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 43 insertions(+), 20 deletions(-) diff --git a/REPORT.md b/REPORT.md index da6f9e00..820c05dc 100644 --- a/REPORT.md +++ b/REPORT.md @@ -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