Packaging et mise en production — Déploiement sur Railway

Dans ce chapitre, vous apprendrez la configuration de l'environnement de production FastAPI et déploierez le blog en production avec Railway.


Gestion de la configuration de l'environnement de production

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

Exemple

# Chemin du fichier : config.py
from pydantic_settings import BaseSettings

class Settings(BaseSettings):
    """Configuration de l'application (lue automatiquement depuis le fichier .env)"""
    app_name: str = "blog EXEMPLE"
    debug: bool = False
    secret_key: str = "dev-secret-key-change-me"
    database_url: str = "sqlite:///./blog.db"
    access_token_expire_minutes: int = 60 * 24 * 7   # 7 jours

    class Config:
        env_file = ".env"     # Spécifier le fichier de variables d'environnement

settings = Settings()

Créez.envFichier :

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

Générer les fichiers de dépendances

(venv) $ pip freeze > requirements.txt

Confirmer que le projet contient les dépendances principales:fastapi、uvicorn、sqlalchemy、jinja2、alembic、passlib、python-jose、python-multipart、sqladmin、pydantic-settings。


Configurer le Procfile et la commande de démarrage

FastAPI utilise un serveur ASGI, contrairement au WSGI de Flask/Django:

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

Si plusieurs workers sont nécessaires (recommandé pour la production):

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

WSGI vs ASGI:Django/Flask utilisent Gunicorn(serveur WSGI),FastAPI utilise Uvicorn(serveur ASGI)。Gunicorn lui-même est WSGI, mais peut être utilisé viauvicorn.workers.UvicornWorkerExécuter une application ASGI.


Poussez vers 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

Déploiement sur Railway

  1. Visitezrailway.app, connectez-vous avec GitHub
  2. Nouveau projet → Déployer depuis le dépôt GitHub → Sélectionner fastapi-blog
  3. Railway détecte automatiquement le Procfile
  4. Définir les variables d'environnement dans Variables
  5. Cliquez sur Deploy

Configuration des variables d'environnement

Nom de la variableValeurDescription
SECRET_KEYLongue chaîne générée aléatoirementClé de signature JWT
DATABASE_URLInjecté par RailwayBase de données de production

Après un déploiement réussi, vous obtiendrez un lien. Visitez /docs pour consulter la documentation Swagger, et visitez /admin pour accéder au panneau d'administration.


Comparaison des frameworks

FonctionnalitésFastAPIDjangoFlask
ORMSQLAlchemyDjango ORM (intégré)Flask-SQLAlchemy
Validation des donnéesPydanticFormulaires DjangoFlask-WTF
Organisation des routesAPIRouterurls.pyBlueprint
Authentification des utilisateursJWT + OAuth2Authentification par session (intégrée)Flask-Login(Session)
Migrations de base de donnéesAlembicmakemigrations / migrateFlask-Migrate
Panneau d'administrationsqladminDjango AdminFlask-Admin
Documentation de l'API/docs (auto)Nécessite drf-spectacularNécessite Flasgger
ServerUvicorn(ASGI)Gunicorn(WSGI)Gunicorn(WSGI)

Prochaines orientations d'apprentissage

Orientation d'apprentissagePour qui est-ce destinéPoint de départ recommandé
SQLAlchemy asynchroneBesoin de meilleures performances de concurrencePasser d'une Session synchrone à AsyncSession
Séparation Frontend/Backend avec FastAPI + Vue3/ReactArchitecture SPA + APIRemplacer les templates Jinja2 par Vue3/React, avec FastAPI en tant que backend API pur.
WebSocketBesoin de push en temps réel (chat, notifications)FastAPI prend nativement en charge WebSocket : @app.websocket()
PostgreSQLBase de données de niveau productionRemplacer DATABASE_URL, installer asyncpg ou psycopg2
autres extensions