Упаковка и запуск в продакшн — развёртывание на Railway

В этой главе вы узнаете о настройке производственной среды FastAPI и развернёте блог в продакшене с помощью Railway.

Управление конфигурацией производственной среды

(venv) $ pip install pydantic-settings python-dotenv

Создайте.envФайл:

SECRET_KEY=a1b2c3d4...your-real-secret-key
DATABASE_URL=sqlite:///./blog.db
DEBUG=False

Сгенерируйте файлы зависимостей

(venv) $ pip freeze > requirements.txt

Подтвердите, что включены основные зависимости：fastapi、uvicorn、sqlalchemy、jinja2、alembic、passlib、python-jose、python-multipart、sqladmin、pydantic-settings.

Настройте Procfile и команду запуска

FastAPI использует ASGI-сервер, в отличие от WSGI во Flask/Django:

web: uvicorn main:app --host 0.0.0.0 --port $PORT

Если требуется несколько воркеров (рекомендуется для продакшена):

web: gunicorn -k uvicorn.workers.UvicornWorker -w 4 main:app

WSGI против ASGI：Django/Flask используют Gunicorn（сервер WSGI），FastAPI использует Uvicorn（сервер ASGI）。Gunicorn сам по себе является WSGI, но может быть доступен черезuvicorn.workers.UvicornWorkerЗапустите ASGI-приложение.

Отправьте на GitHub

$ git init
$ echo "venv/" > .gitignore
$ echo "__pycache__/" >> .gitignore
$ echo "*.pyc" >> .gitignore
$ echo ".env" >> .gitignore
$ git add .
$ git commit -m "初始化 FastAPI 博客项目"
$ git branch -M main
$ git remote add origin https://github.com/你的用户名/fastapi-blog.git
$ git push -u origin main

Развёртывание на Railway

1. Посетитеrailway.app, войдите с помощью GitHub
2. Новый проект → Развернуть из репозитория GitHub → Выберите fastapi-blog
3. Railway автоматически обнаруживает Procfile
4. Задайте переменные окружения в Variables
5. Нажмите Deploy

Настройка переменных окружения

После успешного развёртывания вы получите ссылку. Перейдите на /docs, чтобы посмотреть документацию Swagger, и на /admin, чтобы получить доступ к админ-панели.

Сравнение фреймворков

Следующие направления обучения