forked from mtusi2026/mtusi2026lab3
Compare commits
2
Commits
master
..
025beab4ca
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
025beab4ca | ||
|
|
047c1a2152 |
@@ -1,22 +1,37 @@
|
||||
# Отчёт — лабораторная 3
|
||||
|
||||
- Автор, группа: Никифорова Екатерина, БВТ2301
|
||||
- Целевая оценка: **4** (уровни 3 и 4 выполнены, трек 5 не заявлен)
|
||||
- Commit/PR: #50 (ссылка: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/50)
|
||||
- Использованные источники, библиотеки и помощь ИИ: FastAPI 0.115, Uvicorn 0.30, PostgreSQL 17.6, Valkey 8.1.3, Nginx 1.27, psycopg 3.2, Argon2id. Помощь ИИ при написании кода и отчёта.
|
||||
- Автор, группа: TODO
|
||||
- Целевая оценка; выбранный трек 5, если нужен: TODO
|
||||
- Commit/PR: TODO после публикации
|
||||
- Использованные источники, библиотеки и помощь ИИ: TODO
|
||||
|
||||
## Запуск из чистого clone
|
||||
|
||||
Требования: Docker Engine ≥ 24 с Compose v2, Python ≥ 3.9 (для тестов), `sh` (Git Bash на Windows) или Python.
|
||||
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
|
||||
|
||||
```bash
|
||||
git clone https://gitea.privcloud.tech/eqktrin/mtusi2026lab3.git
|
||||
cd mtusi2026lab3
|
||||
sh scripts/init-secrets.sh # создаёт secrets/* и .env
|
||||
docker compose --env-file .env up -d --build
|
||||
# дождаться готовности
|
||||
until curl -fs localhost:8080/health/ready; do sleep 1; done
|
||||
# публичный smoke
|
||||
python tests/smoke.py --base-url http://localhost:8080
|
||||
# тест отказа (на Windows используйте scripts/stop-one.bat)
|
||||
python tests/resilience.py --mode failover --action-script "scripts/stop-one.bat" --base-url "http://localhost:8080"
|
||||
## Архитектура и решения
|
||||
|
||||
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
|
||||
|
||||
## Доказательства критериев
|
||||
|
||||
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
||||
| --- | --- | --- | --- |
|
||||
| Публичный smoke | make test | TODO | TODO |
|
||||
| Остальные пункты уровня 3 | TODO | TODO | TODO |
|
||||
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
|
||||
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
|
||||
|
||||
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
||||
|
||||
## Эксперименты и отказы
|
||||
|
||||
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
|
||||
|
||||
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|
||||
| --- | --- | --- | --- |
|
||||
| TODO | TODO | TODO | TODO |
|
||||
|
||||
## Ограничения и следующие шаги
|
||||
|
||||
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
||||
|
||||
Reference in New Issue
Block a user