Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
5.4 KiB
Отчёт — лабораторная 3
- Автор, группа: Афанасьев Андрей, БПИ2304
- Целевая оценка: 3
- Трек 5: не заявлен
Запуск
cp .env.example .env
docker compose --env-file .env up -d --build
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose down
Публичный порт принадлежит Nginx и задаётся HOST_PORT (по умолчанию 8080).
Данные PostgreSQL сохраняются в именованном volume postgres_data; намеренное
удаление данных выполняется только командой docker compose down -v.
Архитектура
Nginx балансирует запросы между api1 и api2. Реплики не публикуют порты
наружу. Обе используют общий PostgreSQL и общее хранилище сессий. Каждая
реплика получает стабильный INSTANCE_ID, который возвращается в
X-Instance-Id. Миграция защищена PostgreSQL advisory lock, поэтому две
реплики не выполняют bootstrap одновременно.
Идемпотентность сообщений хранится в PostgreSQL в таблице idempotency_keys.
Уникальный ключ задаётся для пользователя и чата; запись ключа и сообщения
создаётся одной транзакцией. Повтор с тем же body возвращает исходное
сообщение, другой body получает 409.
Проверки
| Проверка | Результат |
|---|---|
make check |
PASS |
make validate PYTHON=.venv/bin/python |
PASS |
make test через Nginx |
PASS |
make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS |
make test-failover ACTION_SCRIPT=scripts/stop-one.sh |
PASS; наблюдались 2 реплики, восстановление за 1.576 с |
Ограничения
Реализован обязательный минимум оценки 3. Redis/Valkey, CPU/RAM-лимиты, rolling update и исследовательские треки оценки 4/5 не заявлены.
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
Запуск из чистого clone
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
Архитектура и решения
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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.