FastAPI Microservices

Микро-сервисы на FastAPI с использованием PostgreSQL, SQLAlchemy 2.0 и Docker.

🚀 Технологии

• FastAPI - веб-фреймворк для создания API
• Uvicorn - ASGI сервер для FastAPI
• SQLAlchemy - ORM для работы с базой данных
• PostgreSQL - реляционная база данных
• Alembic - управление миграциями
• Docker и Docker Compose - контейнеризация
• Make - упрощение команд для запуска проекта
• Poetry - управление зависимостями
• Pydantic - валидация данных
• Loki - система логирования
• Grafana - система мониторинга
• Promtail - инструмент для сбора логов
• Kafka - система обмена сообщениями
• Kafka-UI - визуальный интерфейс для работы с Kafka
• Locust - инструмент для нагрузочного тестирования

🚀 Запуск проекта

Требования

• Docker и Docker Compose
• Python 3.13+
• Poetry
• Make

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/powermacintosh/microservices-example.git
   cd microservices-example

2. Запустите приложение с помощью Makefile:

make build  # Сборка/пересборка проекта
make down   # Остановка проекта
make up     # Запуск проекта

🧪 Запуск тестов

make test

📚 Документация API

После запуска документация API Gateway будет доступна по адресу:

• Swagger UI: http://localhost:5000/docs/

Также API Gateway предоставляет возможность работы с API через GraphQL:

• GraphQL UI: http://localhost:5000/api/v1/graphql

🔧 Настройка окружения для разработки

Создайте файл .env в корне сервиса gateway/, tasks/. Аналогично файлу .env.example.

MODE = DEVELOPMENT

📊 Логирование в Grafana

Логи приложения отправляются в Loki и доступны через Grafana. Grafana: http://localhost:3010

Логин - admin Пароль - admin (при первом входе)

Подключение Loki к Grafana

Путь для подключения Loki к Grafana

Connections => Loki => Add new data source

• Connection-url: http://loki:3100
• ⚙️ Save & Test

Путь для просмотра логов в Grafana

Drilldown => Logs

🎯 Подключение к Kafka-UI

Kafka-UI: http://localhost:8080

🧪 Запуск нагрузочного тестирования Locust

Locust: http://localhost:8089

📄 Лицензия

Этот проект распространяется под лицензией MIT.