5.5 KiB
Запуск перенесённой реализации lab5
В lab6 перенесена реализация lab5 для оценки 4: API-реплики за nginx, PostgreSQL, Redis для сессий, MinIO для файлов, RabbitMQ, outbox publisher, worker и очистка объектов. Сохранены миграции и собственные тесты. OpenTelemetry, Collector и Grafana из задания lab6 пока не реализованы.
Основной стенд
Нужны Python 3.12 и Docker с Compose v2. Версии Python-зависимостей закреплены
в requirements.txt, образы — в Dockerfile и Compose.
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
make init
make check validate
make up
make test
make init создаёт отсутствующие .env и случайные файловые секреты в secrets/.
Секреты и данные из lab5 не копируются. Настройки берутся из .env.example;
дополнительные переменные skeleton lab6 в конце файла пока не подключены.
Миграции БД и настройка MinIO выполняются при запуске.
make up ожидает готовности сервисов. По умолчанию API доступен по
http://localhost:18081 (LB_HOST_PORT); make test и make load используют
этот порт. Его можно переопределить через BASE_URL.
make ps
make logs SERVICE=worker
make load
make down
make down сохраняет данные. Для намеренного удаления всех учебных данных:
docker compose --env-file .env down --volumes.
Compose-проект по умолчанию называется messenger, как в lab5: останавливайте
предыдущий стенд перед запуском либо используйте отдельный COMPOSE_PROJECT_NAME
и свободный LB_HOST_PORT. Одинаковое имя проекта подключает существующие volumes;
для независимого стенда lab6 задайте новое имя до первого запуска.
Перенесённые возможности уровня 4
Загрузка изображения асинхронная: API сохраняет исходник в staging MinIO и задание/outbox в PostgreSQL, publisher отправляет задание в устойчивую очередь RabbitMQ, worker сохраняет варианты и результат в БД, затем подтверждает доставку. Сохранены original, JPEG thumbnail, центральный JPEG crop и WebP, ограничения размера, пикселей, времени, памяти и CPU обработки.
Повторы ограничены бюджетом, задержка растёт со случайным разбросом. Идемпотентность, lease (временное право worker обрабатывать задание), реестр неудачных заданий и ручной replay защищают обработку при повторной доставке. Очистка сохраняет исходники активных заданий и учитывает сроки хранения ready/failed.
docker compose run --rm --no-deps worker python -m app.core.job_admin list-failed
docker compose run --rm --no-deps worker python -m app.core.job_admin replay JOB_ID --request-id REQUEST_UUID --actor operator --reason dependency_restored
JOB_ID и REQUEST_UUID замените UUID. Повтор replay с тем же request-id безопасен.
Проверки
make check проверяет структуру контракта, make validate — OpenAPI.
make test запускает актуальные публичные тесты lab6 на основном стенде.
Собственные тесты lab5 находятся в student-tests/:
make test-stand-up
make test-unit
make test-pipeline
make test BASE_URL=http://localhost:28080
make test-stand-destroy
Тестовый стенд использует отдельный проект messenger-test и порт 28080,
а PostgreSQL/Redis публикуются только локально через compose.test.yaml.
make test-stand-destroy удаляет данные тестового стенда.
make test-suite автоматически поднимает этот стенд, проверяет pipeline,
публичный smoke, S3, outbox и очередь, затем удаляет его вместе с данными.
Полная регрессия запускается отдельно через make test-unit.
Проверки с намеренными отказами запускаются явно:
make test-jobs, make test-outbox, make test-persistence, make test-failover.
Они останавливают или перезапускают компоненты выбранного Compose-проекта.
Для собственных тестов с перезапусками контейнеров: DOCKER_TESTS=1 make test-unit.
Стенд рассчитан на один Docker-хост; репликация хранилищ и защита от потери диска
не реализованы.