Lab 0 — Інфраструктурна підготовка застосунку за стандартами MLOps / DevOps. Застосунок розроблено як "Black Box", що повністю відповідає методології 12-Factor App.
Конфігурація застосунку повністю ізольована від коду. Для запуску сервісу необхідно експортувати такі змінні (або створити файл .env у корені проєкту):
export DB_HOST="localhost" export DB_PORT="5432" export DB_NAME="ecommerce" export DB_USER="postgres" export DB_PASSWORD="your_secure_password" 🚀 Запуск однією командою (One-Command Build) Встановлення залежностей та запуск юніт-тестів виконується стандартними командами: bash
pip install -r requirements.txt
pytest Примітка щодо міграцій БД: Застосунок підтримує автоматичне керування схемою даних за допомогою Alembic. Під час кожного старту сервіс самостійно перевіряє та застосовує нові міграції перед підняттям HTTP-сервера.
🚀 2. Перевірка Production-Grade фіч (Phase 2) 🏥 Глибока перевірка стану (Dependency-Aware Health Check) Сервіс повертає статус 200 OK тільки за умови успішного ping-запиту до бази даних. Якщо БД недоступна — повертається статус 503 Service Unavailable.
Варіант А: База даних підключена (200 OK)
Bash
curl -i http://localhost:8000/health
Варіант Б: База даних вимкнена (503 Service Unavailable)
Bash
curl -i http://localhost:8000/health
📝 Структуроване логування в JSON Усі логи застосунку стандартизовано під формат JSON для подальшого збору системами моніторингу (ELK / Prometheus / Grafana Loki) та виводяться безпосередньо у STDOUT.
Приклад логів під час запуску (ініціалізація та міграції):
JSON
[ВСТАВ СЮДИ РЕАЛЬНІ РЯДКИ ЛОГІВ З ТЕРМІНАЛА, НАПРИКЛАД:]
{"asctime": "2026-05-19 15:30:12,145", "levelname": "INFO", "message": "Application starting up..."}
{"asctime": "2026-05-19 15:30:13,012", "levelname": "INFO", "message": "Running automatic DB migrations..."}
🛑 Плавне завершення роботи (Graceful Shutdown)
Застосунок коректно обробляє сигнал очікування завершення SIGTERM (або SIGINT), логує процес зупинки, закриває пули з'єднань з базою даних без розриву активних транзакцій та завершує роботу з кодом 0.
Логи завершення роботи:
JSON {"asctime": "2026-05-19 15:32:00,501", "levelname": "INFO", "message": "SIGTERM received. Starting graceful shutdown..."} {"asctime": "2026-05-19 15:32:00,502", "levelname": "INFO", "message": "Closing all database connections..."} {"asctime": "2026-05-19 15:32:01,503", "levelname": "INFO", "message": "Graceful shutdown complete. Exiting with code 0."} Сервіс повністю готовий до деплою в кластер (Commerce-Ready).