Packaging und Live-Schaltung — Bereitstellung auf Railway
In diesem Kapitel lernen Sie die Konfiguration der FastAPI-Produktionsumgebung kennen und stellen den Blog mit Railway in der Produktion bereit.
Konfigurationsmanagement der Produktionsumgebung
(venv) $ pip install pydantic-settings python-dotenv
Beispiel
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
"""Anwendungskonfiguration (automatisch aus .env-Datei gelesen)"""
app_name: str = "EXAMPLE blog"
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 Tage
class Config:
env_file = ".env" # Umgebungsvariablendatei angeben
settings = Settings()
Erstelle.envDatei:
SECRET_KEY=a1b2c3d4...your-real-secret-key DATABASE_URL=sqlite:///./blog.db DEBUG=False
Abhängigkeitsdateien generieren
(venv) $ pip freeze > requirements.txt
Bestätigen Sie, dass das Projekt Kernabhängigkeiten enthält:fastapi、uvicorn、sqlalchemy、jinja2、alembic、passlib、python-jose、python-multipart、sqladmin、pydantic-settings。
Procfile und Startbefehl konfigurieren
FastAPI verwendet einen ASGI-Server, anders als das WSGI von Flask/Django:
web: uvicorn main:app --host 0.0.0.0 --port $PORT
Wenn mehrere Worker benötigt werden (empfohlen für die Produktion):
web: gunicorn -k uvicorn.workers.UvicornWorker -w 4 main:app
WSGI vs ASGI:Django/Flask verwenden Gunicorn(WSGI-Server),FastAPI verwendet Uvicorn(ASGI-Server)。Gunicorn selbst ist WSGI, kann aber über
uvicorn.workers.UvicornWorkerASGI-Anwendung ausführen.
Zu GitHub pushen
$ 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-Bereitstellung
- Besuchen Sierailway.app, melden Sie sich mit GitHub an
- Neues Projekt → Aus GitHub-Repo bereitstellen → fastapi-blog auswählen
- Railway erkennt Procfile automatisch
- Umgebungsvariablen in Variables festlegen
- Auf Deploy klicken
Konfiguration der Umgebungsvariablen
| Variablenname | Wert | Beschreibung |
|---|---|---|
| SECRET_KEY | Zufällig generierte lange Zeichenkette | JWT-Signaturschlüssel |
| DATABASE_URL | Von Railway injiziert | Produktionsdatenbank |
Nach erfolgreichem Deployment erhalten Sie einen Link. Besuchen Sie /docs, um die Swagger-Dokumentation anzuzeigen, und besuchen Sie /admin, um auf das Admin-Panel zuzugreifen.
Framework-Vergleich
| Funktionen | FastAPI | Django | Flask |
|---|---|---|---|
| ORM | SQLAlchemy | Django ORM (integriert) | Flask-SQLAlchemy |
| Datenvalidierung | Pydantic | Django-Formulare | Flask-WTF |
| Routenorganisation | APIRouter | urls.py | Blueprint |
| Benutzerauthentifizierung | JWT + OAuth2 | Session-Authentifizierung (integriert) | Flask-Login(Session) |
| Datenbankmigrationen | Alembic | makemigrations / migrate | Flask-Migrate |
| Admin-Panel | sqladmin | Django Admin | Flask-Admin |
| API-Dokumentation | /docs (auto) | Erfordert drf-spectacular | Erfordert Flasgger |
| Server | Uvicorn(ASGI) | Gunicorn(WSGI) | Gunicorn(WSGI) |
Nächste Lernrichtungen
| Lernrichtung | Für wen es gedacht ist | Empfohlener Startpunkt |
|---|---|---|
| Asynchrones SQLAlchemy | Höhere Leistung bei Nebenläufigkeit benötigt | Synchrone Session auf AsyncSession umstellen |
| FastAPI + Vue3/React Frontend/Backend-Trennung | SPA + API-Architektur | Jinja2-Templates durch Vue3/React ersetzen, FastAPI dabei rein als API-Backend. |
| WebSocket | Echtzeit-Push benötigt (Chat, Benachrichtigungen) | FastAPI unterstützt WebSocket nativ: @app.websocket() |
| PostgreSQL | Produktionsreife Datenbank | DATABASE_URL ersetzen, asyncpg oder psycopg2 installieren |