Bij de abonnementen Pro en Team helpt rdev je een project naar productie te brengen en de fouten ervan te zien.
Uitrollen met Deployer
rdev gebruikt Deployer, de standaard deploytool voor PHP. Voer in een Laravel- of WordPress-project uit:
rdev deploy init myapp
Het schrijft een deploy.php vanuit het sjabloon van rdev en voegt Deployer toe aan de dev-dependencies van het project. Vul de repository, de productiehost, de SSH-gebruiker en het pad in en rol dan uit met vendor/bin/dep deploy production. De productieserver heeft PHP, Composer en een webserver nodig; de productie-.env (of wp-config.php) staat op die server en wordt nooit vanaf hier uitgerold.
Je agent kent deze flow ook: vraag hem de uitrol in te stellen en hij vult deploy.php samen met jou in vóór de eerste deploy.
Checklist voor je deployt
Het Laravel-recept in deploy.php installeert de Composer-afhankelijkheden, koppelt storage en de gedeelde .env, voert php artisan storage:link uit, cachet config, routes, views en events, voert php artisan migrate --force uit en bewaart de laatste 5 releases. Het WordPress-recept deelt wp-config.php en wp-content/uploads. De rest is aan jou; loop deze lijst na voor de eerste deploy en voor grote deploys:
- Productie-instellingen:
shared/.envop de server heeft de juiste waarden voorAPP_KEY,APP_URL, database, mail, cache en queue (WordPress:shared/wp-config.php). - Debug uit:
APP_ENV=productionenAPP_DEBUG=false(WordPress:WP_DEBUGisfalse). - Back-ups: maak vlak voor een deploy met migraties een back-up van de productiedatabase.
- Migraties: lees nieuwe migraties één keer door; ze draaien automatisch tijdens de deploy.
- Queue-workers: herstart ze na elke deploy zodat ze de nieuwe code laden. Voeg
after('deploy:success', 'artisan:queue:restart');toe aandeploy.php, of voerphp artisan horizon:terminateuit als je Horizon gebruikt. - Scheduler: voeg eenmalig
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1toe aan de crontab van de deploy-gebruiker (WordPress: een echte cronjob diewp-cron.phpaanroept). - HTTPS: de webserver serveert
current/public(WordPress:current) via HTTPS met een geldig certificaat. - Foutopsporing: koppel het project met
rdev errors connect(hieronder) zodat productiefouten je bereiken. - Rooktest: open na de deploy de homepage, log in, probeer de hoofdflow en kijk in het log naar nieuwe fouten. Gaat er iets mis, dan schakelt
vendor/bin/dep rollback productionterug naar de vorige release.
Deploy-goedkeuringen bij het Team-abonnement
Rol bij het Team-abonnement uit met rdev deploy run production in plaats van Deployer zelf aan te roepen. rdev vraagt eerst om goedkeuring: de eigenaar en de beheerders zien het verzoek op de pagina Jouw team en keuren het goed of wijzen het af, en de deploy start zodra iemand goedkeurt. Een verzoek waarover niemand beslist verloopt na een uur.
Lokale foutopsporing
Met de Pro- en Team-abonnementen kun je GlitchTip, een open-source foutentracker die met Sentry-SDK's werkt, op je eigen server draaien. Het blijft privé binnen je tailnet op https://rdev-errors.dev.test.
Instellen: maak als root (of je sudo-gebruiker) verbinding met je server en voer sudo rdev host errors setup uit. Dit installeert GlitchTip naast je omgeving. Het draait een eigen kleine PostgreSQL-database, gebruikt de Redis van je omgeving, heeft ongeveer 0,7 GB geheugen nodig (begrensd op 1 GB) en ongeveer 1 GB schijfruimte, en bewaart gebeurtenissen 30 dagen. Als het klaar is, toont het het admin-e-mailadres en wachtwoord. Voer rdev errors password op elk moment uit om ze opnieuw te zien, of voer het installatiecommando opnieuw uit om GlitchTip bij te werken en een nieuw wachtwoord te krijgen. Gebruik --email [email protected] om het admin-adres te kiezen. De waarschuwingsmails van GlitchTip verschijnen op je Mail-pagina (https://rdev-mail.dev.test). Registreren staat uit, dus alleen jij kunt inloggen.
Een project koppelen: rdev errors connect my-shop maakt een GlitchTip-project met de naam van de map en schrijft de DSN ervan in het project:
- Laravel: installeert
sentry/sentry-laravelen steltSENTRY_LARAVEL_DSNin.envin. Test het metphp artisan sentry:test. - WordPress: toont de stappen voor de WP Sentry-plugin en de regel die je aan
wp-config.phptoevoegt. - Andere talen: stelt
SENTRY_DSNin.envin. Voeg de Sentry-SDK van je taal toe, dieSENTRY_DSNleest; zorg dat je app.envlaadt, of exporteer de variabele. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, daarnaSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, daarnasentry_sdk.init(); Ruby:bundle add sentry-ruby, daarnaSentry.init; Go:go get github.com/getsentry/sentry-go, daarnasentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Om fouten naar een andere GlitchTip of naar Sentry te sturen, geef je de DSN mee: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Fouten bekijken: open https://rdev-errors.dev.test, of gebruik de knop Errors in de laptop-app, en log in met het admin-e-mailadres en wachtwoord. Zolang foutopsporing niet is ingesteld, laat de pagina zien hoe je het installeert. Codeeragents kunnen de onopgeloste fouten van een project lezen via de MCP-tool rdev_errors.
Foutopsporing
Stuur de fouten van een project naar GlitchTip of Sentry, zelf gehost of in hun cloud. Kopieer daar de DSN van je project en voer dan uit:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: installeert
sentry/sentry-laravelen steltSENTRY_LARAVEL_DSNin.envin. Controleer het metphp artisan sentry:test. - WordPress: toont de stappen voor de WP Sentry-plugin en de regel om aan
wp-config.phptoe te voegen. - Andere projecten: stelt
SENTRY_DSNin.envin voor de Sentry-SDK van je taal.