# Лаб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` — дополнительные проверки, не замена публичных.