forked from mtusi2026/mtusi2026lab2
65 lines
5.6 KiB
Markdown
65 lines
5.6 KiB
Markdown
# Лаб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` — дополнительные проверки, не замена публичных.
|