Files
2026-11-14 03:51:10 +03:00

5.5 KiB
Raw Permalink Blame History

Запуск перенесённой реализации 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-хост; репликация хранилищ и защита от потери диска не реализованы.