Typ minstens twee letters om elke pagina van de docs te doorzoeken.

↑ ↓ om te navigeren ↵ om te openen esc om te sluiten

rdev gebruiken

Uitrollen en foutopsporing

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/.env op de server heeft de juiste waarden voor APP_KEY, APP_URL, database, mail, cache en queue (WordPress: shared/wp-config.php).
  • Debug uit: APP_ENV=production en APP_DEBUG=false (WordPress: WP_DEBUG is false).
  • 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 aan deploy.php, of voer php artisan horizon:terminate uit als je Horizon gebruikt.
  • Scheduler: voeg eenmalig * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 toe aan de crontab van de deploy-gebruiker (WordPress: een echte cronjob die wp-cron.php aanroept).
  • 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 production terug 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-laravel en stelt SENTRY_LARAVEL_DSN in .env in. Test het met php artisan sentry:test.
  • WordPress: toont de stappen voor de WP Sentry-plugin en de regel die je aan wp-config.php toevoegt.
  • Andere talen: stelt SENTRY_DSN in .env in. Voeg de Sentry-SDK van je taal toe, die SENTRY_DSN leest; zorg dat je app .env laadt, of exporteer de variabele. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, daarna Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, daarna sentry_sdk.init(); Ruby: bundle add sentry-ruby, daarna Sentry.init; Go: go get github.com/getsentry/sentry-go, daarna sentry.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-laravel en stelt SENTRY_LARAVEL_DSN in .env in. Controleer het met php artisan sentry:test.
  • WordPress: toont de stappen voor de WP Sentry-plugin en de regel om aan wp-config.php toe te voegen.
  • Andere projecten: stelt SENTRY_DSN in .env in voor de Sentry-SDK van je taal.