Packaging für die Produktion — Deployment auf Railway

In diesem Kapitel lernen Sie, wie Sie die Produktionsumgebung konfigurieren, die Django-Blog-Anwendung auf Railway bereitstellen und einen öffentlichen Zugriffslink erhalten.


Konfiguration der Produktionsumgebung

In der Entwicklungsumgebung ist DEBUG=True, und Django zeigt detaillierte Fehlerinformationen und Debug-Seiten an.

In der Produktionsumgebung muss DEBUG deaktiviert werden, und Sicherheitsoptionen müssen korrekt konfiguriert werden.

settings.py Produktionskonfiguration

Beispiel

# Dateipfad: blog_project/settings.py
import os

# Secret Key aus einer Umgebungsvariable lesen (nicht im Code hartkodieren)
SECRET_KEY = os.environ.get('SECRET_KEY', 'Standard-Secret-Key für die Entwicklungsumgebung')

# DEBUG wird über Umgebungsvariablen gesteuert.
DEBUG = os.environ.get('DEBUG', 'True').lower() == 'true'

# Erlaubte Hostnamen
ALLOWED_HOSTS = os.environ.get('ALLOWED_HOSTS', '127.0.0.1,localhost').split(',')

# Verzeichnis zum Sammeln statischer Dateien
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')   # staticfiles/ im Stammverzeichnis des Projekts
STATIC_URL = '/static/'

SECRET_KEYEr ist Djangos wichtigster Sicherheitsschlüssel, der zum Verschlüsseln von Sitzungen, CSRF-Tokens usw. verwendet wird. Er darf niemals im Code fest codiert oder in Git committet werden. In der Produktionsumgebung wird er über Umgebungsvariablen injiziert.


Abhängigkeitsverwaltung und requirements.txt

Erzeuge eine Abhängigkeitsliste; die Bereitstellungsplattform verwendet sie, um die vom Projekt benötigten Pakete zu installieren.

(venv) $ pip freeze > requirements.txt

Überprüfe den Dateiinhalt, um sicherzustellen, dass die folgenden wichtigen Abhängigkeiten enthalten sind:

Django>=5.0,<6.0
gunicorn>=21.0              # 生产级 WSGI 服务器
whitenoise>=6.0             # 静态文件服务(可选)

Wenn gunicorn nicht vorhanden ist, installiere es zuerst:

(venv) $ pip install gunicorn
(venv) $ pip freeze > requirements.txt

Konfiguriere Gunicorn + Whitenoise

Djangos eingebauterrunserverNicht für die Produktionsumgebung geeignet.

GunicornEs ist ein produktionsreifer WSGI-Server für Python, der gleichzeitige Anfragen verarbeitet.

WhitenoiseErmöglicht Gunicorn, statische Dateien (CSS, JS, Bilder) direkt auszuliefern.

Beispiel

# Dateipfad: blog_project/settings.py

# Die Whitenoise-Middleware muss nach SecurityMiddleware und vor anderer Middleware platziert werden.
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',   # Hinzufügen: Middleware für statische Dateien
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

Im Projektstammverzeichnis erstellenProcfileRailway mitteilen, wie die Anwendung gestartet wird:

web: gunicorn blog_project.wsgi --log-file -

Statische Dateien sammeln

In der Produktionsumgebung stellt Django statische Dateien nicht automatisch bereit; Sie müssen verwendencollectstaticIn ein einheitliches Verzeichnis sammeln.

(venv) $ python manage.py collectstatic

Dieser Befehl kopiert die statischen Dateien des Admin-Backends und der Blog-App nachSTATIC_ROOTVerzeichnis (staticfiles/).

In einer Entwicklungsumgebung müssen Sie normalerweise nicht collectstatic ausführen (Django findet das statische Verzeichnis jeder App automatisch). Vor der Bereitstellung muss es jedoch ausgeführt werden, um sicherzustellen, dass alle statischen Dateien in einem Verzeichnis zusammengeführt werden, das der Webserver verwenden kann.


Das Projekt zu GitHub pushen

.gitignore erstellen

Stellen Sie sicher, dass sensible Dateien und temporäre Dateien nicht committet werden:

venv/
__pycache__/
*.pyc
db.sqlite3
staticfiles/
.env

Zu GitHub pushen

$ git init
$ git add .
$ git commit -m "初始化 Django 博客项目"
$ git branch -M main
$ git remote add origin https://github.com/你的用户名/django-blog.git
$ git push -u origin main

Railway-Bereitstellung

RailwayEs ist eine aufstrebende Cloud-Deployment-Plattform mit guter Unterstützung für Full-Stack-Anwendungen wie Django.

Bereitstellungsschritte

  1. Besuchen Sierailway.app, und melden Sie sich mit einem GitHub-Konto an
  2. Klicken Sie auf „New Project“ → „Deploy from GitHub repo“ → django-blog 仓library auswählen
  3. Railway erkennt die Procfile automatisch und ermittelt den Startbefehl.
  4. Umgebungsvariablen in Variables festlegen.
  5. Klicken Sie auf Deploy und warten Sie, bis Build und Deployment abgeschlossen sind.

Konfiguration der Umgebungsvariablen

VariablennameWertBeschreibung
SECRET_KEYZufällig generierte lange ZeichenketteDjango-Sicherheitsschlüssel
DEBUGFalseDebugmodus deaktivieren
ALLOWED_HOSTS.railway.appZugriff von der Railway-Domain erlauben.

SECRET_KEY schnell generieren:

$ python -c "import secrets; print(secrets.token_urlsafe(50))"

Nach erfolgreichem Deployment erhalten Sie einen Link wie:https://django-blog.up.railway.app

Das kostenlose Kontingent von Railway ist begrenzt ($5 pro Monat oder 500 Stunden). Wenn Sie nur testen oder lernen, denken Sie daran, das Projekt nach dem Aufbrauchen zu pausieren. Heroku hat seinen kostenlosen Tarif eingestellt, daher empfiehlt dieses Tutorial Railway als Alternative.


Nächste Lernrichtung

LernrichtungFür wen es gedacht istEmpfohlener Startpunkt
Django REST Framework (DRF)Ein API-Backend für Frontend-Frameworks (Vue3/React) muss erstellt werden.Serializer + ViewSet lernen, um den Blog in einen API-Dienst umzuwandeln
PostgreSQLEine produktionsreife Datenbank wird benötigtSQLite ersetzen und django-environ zur Verwaltung der Datenbankkonfiguration verwenden
Asynchrone Celery-AufgabeBenötigen Hintergrundaufgaben (Senden von E-Mails, Generieren von Berichten).Redis + Celery integrieren, um eine asynchrone Aufgabenwarteschlange zu implementieren.
Django + Vue3/React Frontend-Backend-TrennungMöchten eine getrennte Frontend-/Backend-ArchitekturDas API-Backend mit DRF erstellen, das Frontend mit Vue3/React erstellen und über fetch kommunizieren

Kapitelzusammenfassung

In diesem Kapitel hast du den letzten Schritt abgeschlossen: Konfigurieren der Produktionsumgebung (SECRET_KEY/DEBUG/ALLOWED_HOSTS), Generieren von requirements.txt, Konfigurieren von Gunicorn + Procfile, Push zu GitHub und One-Click-Deployment auf Railway.

Weitere Erweiterungen