In den Tarifen Pro und Team hilft Ihnen rdev, ein Projekt in Produktion zu bringen und dessen Fehler zu sehen.
Deployment mit Deployer
rdev verwendet Deployer, das Standard-Deployment-Tool für PHP. Führen Sie in einem Laravel- oder WordPress-Projekt aus:
rdev deploy init myapp
Es schreibt eine deploy.php aus der Vorlage von rdev und fügt Deployer zu den Dev-Abhängigkeiten des Projekts hinzu. Tragen Sie das Repository, den Produktionshost, den SSH-Benutzer und den Pfad ein und deployen Sie dann mit vendor/bin/dep deploy production. Der Produktionsserver braucht PHP, Composer und einen Webserver; die Produktions-.env (oder wp-config.php) liegt auf diesem Server und wird nie von hier aus deployt.
Auch Ihr Agent kennt diesen Ablauf: Bitten Sie ihn, das Deployment einzurichten, und er füllt die deploy.php gemeinsam mit Ihnen aus, bevor das erste Deployment läuft.
Checkliste vor dem Deployment
Das Laravel-Rezept in deploy.php installiert die Composer-Abhängigkeiten, verlinkt storage und die geteilte .env, führt php artisan storage:link aus, cacht Konfiguration, Routen, Views und Events, führt php artisan migrate --force aus und behält die letzten 5 Releases. Das WordPress-Rezept teilt wp-config.php und wp-content/uploads. Der Rest liegt bei Ihnen; gehen Sie diese Liste vor dem ersten Deployment und vor großen Deployments durch:
- Produktionseinstellungen:
shared/.envauf dem Server enthält die richtigen Werte fürAPP_KEY,APP_URL, Datenbank, Mail, Cache und Queue (WordPress:shared/wp-config.php). - Debug aus:
APP_ENV=productionundAPP_DEBUG=false(WordPress:WP_DEBUGistfalse). - Backups: Erstellen Sie direkt vor einem Deployment mit Migrationen ein Backup der Produktionsdatenbank.
- Migrationen: Lesen Sie neue Migrationen einmal durch; sie laufen beim Deployment automatisch.
- Queue-Worker: Starten Sie sie nach jedem Deployment neu, damit sie den neuen Code laden. Fügen Sie
after('deploy:success', 'artisan:queue:restart');zudeploy.phphinzu, oder führen Sie mit Horizonphp artisan horizon:terminateaus. - Scheduler: Fügen Sie einmal
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1zur Crontab des Deploy-Benutzers hinzu (WordPress: ein echter Cronjob, derwp-cron.phpaufruft). - HTTPS: Der Webserver liefert
current/public(WordPress:current) über HTTPS mit gültigem Zertifikat aus. - Fehlerverfolgung: Verbinden Sie das Projekt mit
rdev errors connect(unten), damit Produktionsfehler Sie erreichen. - Smoke-Test: Öffnen Sie nach dem Deployment die Startseite, melden Sie sich an, testen Sie den Hauptablauf und prüfen Sie das Log auf neue Fehler. Stimmt etwas nicht, wechselt
vendor/bin/dep rollback productionzum vorherigen Release zurück.
Deploy-Freigaben im Team-Tarif
Deployen Sie im Team-Tarif mit rdev deploy run production, statt Deployer selbst aufzurufen. rdev fragt zuerst nach einer Freigabe: Der Inhaber und die Administratoren sehen die Anfrage auf der Seite Ihr Team und geben sie frei oder lehnen sie ab, und das Deployment startet, sobald jemand freigibt. Eine Anfrage, über die niemand entscheidet, läuft nach einer Stunde ab.
Lokale Fehlerverfolgung
In den Tarifen Pro und Team können Sie GlitchTip, einen Open-Source-Fehlertracker, der mit Sentry-SDKs funktioniert, auf Ihrem eigenen Server betreiben. Er bleibt privat in Ihrem Tailnet unter https://rdev-errors.dev.test.
Einrichtung: Verbinden Sie sich als root (oder als Ihr sudo-Benutzer) mit Ihrem Server und führen Sie sudo rdev host errors setup aus. Das installiert GlitchTip neben Ihrer Umgebung. Es betreibt eine eigene kleine PostgreSQL-Datenbank, nutzt das Redis Ihrer Umgebung, braucht etwa 0,7 GB Arbeitsspeicher (begrenzt auf 1 GB) und etwa 1 GB Speicherplatz und behält Ereignisse 30 Tage. Zum Schluss gibt es die Admin-E-Mail und das Passwort aus. Mit rdev errors password sehen Sie beides jederzeit wieder; führen Sie den Setup-Befehl erneut aus, um GlitchTip zu aktualisieren und ein neues Passwort zu erhalten. Mit --email [email protected] wählen Sie die Admin-Adresse. Die Warn-E-Mails von GlitchTip erscheinen auf Ihrer Mail-Seite (https://rdev-mail.dev.test). Die Registrierung ist abgeschaltet, nur Sie können sich anmelden.
Projekt verbinden: rdev errors connect my-shop legt ein GlitchTip-Projekt mit dem Namen des Ordners an und schreibt dessen DSN ins Projekt:
- Laravel: installiert
sentry/sentry-laravelund setztSENTRY_LARAVEL_DSNin.env. Testen Sie es mitphp artisan sentry:test. - WordPress: gibt die Schritte für das Plugin WP Sentry und die Zeile für
wp-config.phpaus. - Andere Sprachen: setzt
SENTRY_DSNin.env. Fügen Sie das Sentry-SDK Ihrer Sprache hinzu, dasSENTRY_DSNliest; stellen Sie sicher, dass Ihre App.envlädt, oder exportieren Sie die Variable. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, dannSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, dannsentry_sdk.init(); Ruby:bundle add sentry-ruby, dannSentry.init; Go:go get github.com/getsentry/sentry-go, dannsentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Um Fehler stattdessen an ein anderes GlitchTip oder an Sentry zu senden, übergeben Sie dessen DSN: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Fehler ansehen: Öffnen Sie https://rdev-errors.dev.test oder nutzen Sie die Schaltfläche Errors in der Laptop-App und melden Sie sich mit Admin-E-Mail und Passwort an. Solange die Fehlerverfolgung nicht eingerichtet ist, zeigt die Seite, wie man sie installiert. Coding-Agenten können die ungelösten Fehler eines Projekts über das MCP-Tool rdev_errors lesen.
Fehlerverfolgung
Senden Sie die Fehler eines Projekts an GlitchTip oder Sentry, selbst gehostet oder in deren Cloud. Kopieren Sie dort den DSN Ihres Projekts und führen Sie dann aus:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: installiert
sentry/sentry-laravelund setztSENTRY_LARAVEL_DSNin der.env. Prüfen Sie es mitphp artisan sentry:test. - WordPress: gibt die Schritte für das Plugin WP Sentry und die Zeile aus, die Sie in
wp-config.phpeinfügen. - Andere Projekte: setzt
SENTRY_DSNin der.envfür das Sentry-SDK Ihrer Sprache.