Files
2026-11-13 11:08:23 +03:00

65 lines
5.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Лаб2: с чего начать
Цель — уровень **4**, C# / ASP.NET Core 10, PostgreSQL и Redis.
**Статус:** C# собран; локальные проверки перечислены в `evidence/`. Полный Docker-стенд в среде подготовки не запускался. До успешного выполнения `scripts/verify.py` нельзя говорить, что лабораторная полностью проверена или оценка 4 доказана.
## Запуск на Kubuntu (рекомендуемый путь)
Распакуйте архив в отдельную папку, не поверх Лаб1. Откройте терминал в корне, где лежит `compose.yaml`.
Нужны Docker с Compose v2, Python 3.9+, интернет для скачивания образов/NuGet. Системный .NET не нужен: сборка внутри Docker. Порт 8080 должен быть свободен. Если там ещё Лаб1, остановите её: `docker stop mtusi-messenger-lab1`. Это сохраняет контейнер Лаб1.
```sh
python3 scripts/setup.py
docker compose config --quiet
docker compose up -d --build --wait --wait-timeout 120
python3 tests/smoke.py
```
Затем полная проверка (автоматически собирает/запускает стенд и выполняет все сценарии):
```sh
chmod +x scripts/restart.sh
python3 scripts/verify.py
```
Она занимает несколько минут, создаёт синтетические данные, кратковременно останавливает БД/Redis/API и восстанавливает их. Во время проверки не работайте с этим стендом из других терминалов. Обязательный обычный TTL — 3600; короткий TTL включается и возвращается автоматически. Не запускайте это против чужого/рабочего сервиса.
При успехе пришлите `evidence/acceptance.json`, `evidence/explain.txt`, `evidence/resilience.py.txt` и `evidence/restart-before.txt` / `restart-after.txt`. При неуспехе — текст ошибки и вывод `docker compose ps`; если ошибка сборки — последние строки `docker compose build`. `.env` и `secrets/` присылать не нужно.
Если первая сборка очень долгая, выполните отдельно `docker compose build`, затем повторите запуск. Для диагностики: `docker compose logs --tail=100 api`. Приложение не пишет пароли и токены в логи.
## Проверки отдельно
```sh
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
# Без make:
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh
# План SQL без Python-runner:
docker compose exec -T postgres psql -X -U messenger -d messenger -v ON_ERROR_STOP=1 < scripts/explain.sql
```
`make validate` требует `pip install -r requirements-dev.txt` в виртуальном окружении. Если нужен локальный C# build: установите SDK из `global.json` (10.0.403), затем `dotnet build src/Messenger -c Release` и `dotnet run --project tests_own/UnitChecks -c Release`. SDK 9 не собирает target net10.0.
## Остановка
`docker compose stop` останавливает процессы, данные остаются. `docker compose up -d` запускает их снова. `docker compose down` удаляет контейнеры и сеть, но сохраняет именованные тома.
**Только для намеренного полного сброса учебных данных:** `docker compose down -v`. После этого пользователи, чаты, сообщения и сессии исчезнут. Не выполняйте эту команду в тесте сохранности.
`secrets/` храните вместе с проектом. Повторный setup сохраняет существующие значения. Удаление secrets при сохранённом томе PostgreSQL создаст новые реквизиты, которые не совпадут с паролем уже созданной БД. В таком случае нужно восстановить прежние secrets, а не просто снова запускать setup.
На Windows полный сценарий с `restart.sh` выполняйте в WSL2 с Docker Desktop integration. Python в Windows без WSL не сможет напрямую выполнить POSIX shell hook. Kubuntu уже подходит.
## Что читать
1. `EXPLANATION.md` — что изменилось и как работает код.
2. `ERRORS.md` — обнаруженные проблемы, исправления и ограничения проверки.
3. `DEFENSE.md` — вопросы и ответы для защиты.
4. `REPORT.md` — технический отчёт; после проверки дописать реальные результаты и автора/группу.
Оригинальные публичные `tests/`, контракт и задание сохранены без изменений. `scripts/verify.py` — дополнительные проверки, не замена публичных.