FastAPI Template

Минимальный шаблон FastAPI-приложения с Dockerfile и Makefile.

Структура

main.py
Dockerfile
requirements.txt
Makefile

Локальный запуск без Docker

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
make dev

На Windows PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
uvicorn main:app --reload

Команды Makefile

make install       # установить зависимости
make dev           # запустить dev-сервер с reload
make run           # запустить production-like сервер
make docker-build  # собрать Docker-образ
make docker-run    # запустить контейнер
make clean         # удалить __pycache__

API будет доступен по адресу:

• http://localhost:8000
• http://localhost:8000/docs
• http://localhost:8000/health

Деплой

1. Скопируйте .env.example в .env и задайте production-значения.
2. Укажите реальные домены в CORS_ORIGINS.
3. Соберите образ:

docker build -t fastapi-template .

4. Запустите контейнер:

docker run -d --name fastapi-template --env-file .env -p 8000:8000 fastapi-template

Переменные окружения

• APP_NAME - название приложения.
• APP_VERSION - версия приложения.
• ENVIRONMENT - окружение: development, staging, production.
• DEBUG - режим отладки.
• CORS_ORIGINS - список разрешенных origin в JSON-формате.