Die Pipeline baut aus deinem Backend ein Docker-Image und deployt es auf den Server des Projekts; für Produktion brauchst du eine Domain für die API. Den Deploy-Ablauf beschreibt Git-Workflow und Deployment.
Was mit dem Backend auf den Server kommt
Die MySQL-Datenbank läuft als eigener Container auf demselben Server, ihre Daten liegen unter ./backend-mysql. In der Projektkonfiguration schaltest du phpMyAdmin und Easy Backup ein. Traefik leitet die API-Domain an den Container weiter, HTTPS richtet die Plattform ein.
Uploads
Nutzer-Uploads gehören lokal in ./upload und im Container nach /app/upload. Auf dem Server hängt das Deployment ./backend-uploads an diesen Pfad. Multer, der FastAPI-Upload-Handler oder Laravel Storage müssen auf diesen Pfad zeigen und nicht auf Verzeichnisse wie user-uploads oder /app/uploads. Das generierte Dockerfile legt den Ordner mit RUN mkdir -p upload an.
Konfiguration und Secrets je Umgebung
Die Konfiguration je Umgebung liegt im gitops-configuration-Repository unter configurations/. generated.yaml pflegt die Plattform, darunter Hostnamen, Registry und verschlüsselte Secrets. Eigene Umgebungsvariablen trägst du in custom.yaml unter additional_env_variables ein; ein Commit auf main dieses Repositories rollt sie aus. Die Einzelheiten stehen unter Umgebungsvariablen.
Für den E-Mail-Versand wählst du im Projekt einen Mail-Account aus den Anbindungen, wie unter E-Mail-Versand beschrieben.
Die Adressen deines Backends
| Umgebung | URL |
|---|---|
| Dev | backend.dev.<projekt>.<organisations-domain>, automatisch vergeben |
| Produktion | deine eigene API-Domain aus der Projekt-Konfiguration |
| phpMyAdmin auf Dev | phpmyadmin.dev.<projekt>.<organisations-domain> |
Die DNS-Einträge für die API-Domain zeigt die Plattform im Domain-Detail; die Schritte stehen unter DNS konfigurieren. Eine Web-App desselben Projekts bekommt die Backend-URL über die generierten Env-Dateien (Web-Apps veröffentlichen).
Fehler landen in deinem Sentry-Projekt, sobald du die Komponente unter Funktionen dafür aktivierst (Error-Tracking); wie du ein Release zurücknimmst, steht unter Betrieb.