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
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é via
uvicorn.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
- Visitezrailway.app, connectez-vous avec GitHub
- Nouveau projet → Déployer depuis le dépôt GitHub → Sélectionner fastapi-blog
- Railway détecte automatiquement le Procfile
- Définir les variables d'environnement dans Variables
- Cliquez sur Deploy
Configuration des variables d'environnement
| Nom de la variable | Valeur | Description |
|---|---|---|
| SECRET_KEY | Longue chaîne générée aléatoirement | Clé de signature JWT |
| DATABASE_URL | Injecté par Railway | Base 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és | FastAPI | Django | Flask |
|---|---|---|---|
| ORM | SQLAlchemy | Django ORM (intégré) | Flask-SQLAlchemy |
| Validation des données | Pydantic | Formulaires Django | Flask-WTF |
| Organisation des routes | APIRouter | urls.py | Blueprint |
| Authentification des utilisateurs | JWT + OAuth2 | Authentification par session (intégrée) | Flask-Login(Session) |
| Migrations de base de données | Alembic | makemigrations / migrate | Flask-Migrate |
| Panneau d'administration | sqladmin | Django Admin | Flask-Admin |
| Documentation de l'API | /docs (auto) | Nécessite drf-spectacular | Nécessite Flasgger |
| Server | Uvicorn(ASGI) | Gunicorn(WSGI) | Gunicorn(WSGI) |
Prochaines orientations d'apprentissage
| Orientation d'apprentissage | Pour qui est-ce destiné | Point de départ recommandé |
|---|---|---|
| SQLAlchemy asynchrone | Besoin de meilleures performances de concurrence | Passer d'une Session synchrone à AsyncSession |
| Séparation Frontend/Backend avec FastAPI + Vue3/React | Architecture SPA + API | Remplacer les templates Jinja2 par Vue3/React, avec FastAPI en tant que backend API pur. |
| WebSocket | Besoin de push en temps réel (chat, notifications) | FastAPI prend nativement en charge WebSocket : @app.websocket() |
| PostgreSQL | Base de données de niveau production | Remplacer DATABASE_URL, installer asyncpg ou psycopg2 |