FastAPI в проде: деплой на боевой сервер

За 4 часа вы пройдёте полный цикл деплоя FastAPI-приложения на боевой сервер:

• Запустите FastAPI через gunicorn как системный сервис systemd

• Настроите nginx reverse proxy через unix-сокет

• Научитесь читать логи (journalctl, nginx access/error) и находить причину падения

• Пройдёте отладку по словарю из 8 типовых ошибок деплоя

• Соберёте цикл целиком: код → gunicorn → systemd → nginx → отладка

✅ Зачем эта лаба?

Большинство туториалов по FastAPI заканчиваются на команде uvicorn main:app. Запустил на ноуте — работает. Выкатил на сервер — 502, процесс упал, логи непонятные.

Разрыв между «работает у меня» и «работает в проде» — именно его закрывает эта лаба. Вы пройдёте путь от кода до рабочего сервиса за nginx, своими руками, на собственной виртуальной машине.

Правильная связка в проде:

код FastAPI → gunicorn (N workers) → systemd (автоперезапуск) → nginx (reverse proxy) → интернет

✅ Для кого

Python-разработчики (junior/middle), которые:

• Уже пишут на FastAPI или прошли воркшоп «Основы FastAPI» (6 августа)

• Никогда не деплоили приложение в прод сами

• Хотят понять, что происходит между «написал код» и «сервис доступен по URL»

• Готовятся к первому прод-деплою на работе

Пререквизиты: базовое владение командной строкой Linux (SSH, навигация, права), Python 3.10+. Опыт с FastAPI — желательно.

✅ Программа лабораторной (4 блока + бонус, 4 часа)

Блок 1: gunicorn + UvicornWorker (50 мин)

Запуск FastAPI через gunicorn с UvicornWorker. Конфигурация workers под ядра сервера. Unix-сокет vs TCP — почему в проде чаще выбирают unix.

Блок 2: systemd (50 мин)

Написание .service unit-файла: автозапуск при загрузке, перезапуск при падении, управление через systemctl. Чтение логов через journalctl -u.

Блок 3: nginx (50 мин)

Настройка nginx как reverse proxy: приём запросов из интернета, передача в gunicorn через unix-сокет. Server block, access/error логи, раздача статики.

Блок 4: Отладка (50 мин) — ключевой блок!

Словарь из 8 типовых ошибок деплоя с алгоритмом диагностики для каждой: 502 Bad Gateway, занятый порт, права на сокет, потерянные переменные окружения, падающие workers и другие.

Бонус: HTTPS в проде (20 мин) — теория

TLS-терминирование, Let's Encrypt, ACME-протокол, certbot. Без live-демо — для практики нужен домен. Честно о теории, чтобы знать, что гуглить дальше.

✅ Вы уйдёте с результатами

Компетенции, которые вы прокачаете:

✓ Запуск FastAPI через gunicorn как systemd-сервис

✓ Настройка nginx reverse proxy через unix-сокет

✓ Чтение логов (journalctl, nginx) и диагностика падений

✓ Полный цикл: код → gunicorn → systemd → nginx → отладка

Что получите «на руки»:

✓ Работающий .service unit-файл

✓ nginx.conf server block

✓ Чек-лист «деплой упал — первые 5 шагов»

✓ Доступ к собственной ВМ на время лабы

✅ Чем эта лаба отличается

✓ Полный цикл своими руками — не демонстрация, а работа на собственной ВМ

✓ Словарь реальных ошибок — 8 типовых проблем деплоя с алгоритмом диагностики

✓ От кода до nginx — сквозной проект: вы видите, как запрос проходит всю цепочку

✓ Честно про HTTPS — теория без обещаний live-демо, которое невозможно повторить без домена

✓ Продолжение воркшопа — естественный следующий шаг после «Основ FastAPI» (6 августа)

✅ Предпосылки и формат

Требования к участникам:

• Python 3.10+ на вашем компьютере (для SSH-доступа к ВМ)

• Базовое владение командной строкой Linux (SSH, навигация, права файлов)

• Опыт с FastAPI — желательно (воркшоп 06.08 или эквивалентный уровень)

Формат проведения:

• Онлайн-лабораторная, 4 часа (10:00–14:00 МСК)

• Каждый участник — на своей ВМ, полный цикл от кода до nginx своими руками

• Стек: Python 3.10+, FastAPI, gunicorn, systemd, nginx

✅ Дальнейший маршрут развития

Эта лаба — часть цепочки, в которой каждый блок усиливает следующий:

• � Linux: первый сервер — база для всего: командная строка, процессы, права, сеть

• � Docker для начинающих (Максим Тачков) — упакуйте свой FastAPI-сервис в контейнер

• � Основы FastAPI: сервис «прочитать позже» (Ольга Пичужкина, 06.08) — воркшоп, на котором пишется приложение, которое мы здесь деплоим

• � MCP Knowledge Server (сентябрь) — на FastAPI построен AI-ассистент сообщества

Даты проведения:

• 22 августа 2026, 10:00–14:00 МСК

Что получают участники:

• [x] Живая онлайн-лабораторная с практикой в реальном времени (4 часа)

• [x] Доступ к собственной виртуальной машине на время лабы

• [x] Работающий .service unit-файл и nginx.conf

• [x] Чек-лист «деплой упал — первые 5 шагов»

• [x] Возможность задать вопросы ведущей в прямом эфире

• [x] Приглашение в чат сообщества «Полный стек»

Ведущая: Ольга Пичужкина

• Middle Python Developer — 5+ лет backend-разработки

• Бакалавр компьютерной лингвистики (НИУ ВШЭ)

• В сообществе «Полный стек» ведёт лабораторные работы по Python

• Стек: Python, FastAPI, SQLAlchemy, Pydantic, gunicorn, nginx, systemd