5.6 KiB
Лаб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.
python3 scripts/setup.py
docker compose config --quiet
docker compose up -d --build --wait --wait-timeout 120
python3 tests/smoke.py
Затем полная проверка (автоматически собирает/запускает стенд и выполняет все сценарии):
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. Приложение не пишет пароли и токены в логи.
Проверки отдельно
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 уже подходит.
Что читать
EXPLANATION.md— что изменилось и как работает код.ERRORS.md— обнаруженные проблемы, исправления и ограничения проверки.DEFENSE.md— вопросы и ответы для защиты.REPORT.md— технический отчёт; после проверки дописать реальные результаты и автора/группу.
Оригинальные публичные tests/, контракт и задание сохранены без изменений. scripts/verify.py — дополнительные проверки, не замена публичных.