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

# Dateipfad: config.py
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 überuvicorn.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

  1. Besuchen Sierailway.app, melden Sie sich mit GitHub an
  2. Neues Projekt → Aus GitHub-Repo bereitstellen → fastapi-blog auswählen
  3. Railway erkennt Procfile automatisch
  4. Umgebungsvariablen in Variables festlegen
  5. Auf Deploy klicken

Konfiguration der Umgebungsvariablen

VariablennameWertBeschreibung
SECRET_KEYZufällig generierte lange ZeichenketteJWT-Signaturschlüssel
DATABASE_URLVon Railway injiziertProduktionsdatenbank

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

FunktionenFastAPIDjangoFlask
ORMSQLAlchemyDjango ORM (integriert)Flask-SQLAlchemy
DatenvalidierungPydanticDjango-FormulareFlask-WTF
RoutenorganisationAPIRouterurls.pyBlueprint
BenutzerauthentifizierungJWT + OAuth2Session-Authentifizierung (integriert)Flask-Login(Session)
DatenbankmigrationenAlembicmakemigrations / migrateFlask-Migrate
Admin-PanelsqladminDjango AdminFlask-Admin
API-Dokumentation/docs (auto)Erfordert drf-spectacularErfordert Flasgger
ServerUvicorn(ASGI)Gunicorn(WSGI)Gunicorn(WSGI)

Nächste Lernrichtungen

LernrichtungFür wen es gedacht istEmpfohlener Startpunkt
Asynchrones SQLAlchemyHöhere Leistung bei Nebenläufigkeit benötigtSynchrone Session auf AsyncSession umstellen
FastAPI + Vue3/React Frontend/Backend-TrennungSPA + API-ArchitekturJinja2-Templates durch Vue3/React ersetzen, FastAPI dabei rein als API-Backend.
WebSocketEchtzeit-Push benötigt (Chat, Benachrichtigungen)FastAPI unterstützt WebSocket nativ: @app.websocket()
PostgreSQLProduktionsreife DatenbankDATABASE_URL ersetzen, asyncpg oder psycopg2 installieren
Weitere Erweiterungen