Saisissez au moins deux lettres pour rechercher dans toutes les pages de la documentation.

↑ ↓ pour naviguer ↵ pour ouvrir esc pour fermer

Utiliser rdev

Déploiement et suivi des erreurs

Avec les offres Pro et Team, rdev vous aide à mettre un projet en production et à en voir les erreurs.

Déployer avec Deployer

rdev utilise Deployer, l'outil de déploiement standard pour PHP. Dans un projet Laravel ou WordPress, exécutez :

rdev deploy init myapp

Il écrit un deploy.php à partir du modèle de rdev et ajoute Deployer aux dépendances de développement du projet. Renseignez le dépôt, l'hôte de production, l'utilisateur SSH et le chemin, puis déployez avec vendor/bin/dep deploy production. Le serveur de production a besoin de PHP, de Composer et d'un serveur web ; le .env de production (ou wp-config.php) vit sur ce serveur et n'est jamais déployé d'ici.

Votre agent connaît aussi ce flux : demandez-lui de configurer le déploiement, et il remplit deploy.php avec vous avant le premier déploiement.

Liste de contrôle avant de déployer

La recette Laravel de deploy.php installe les dépendances Composer, lie storage et le .env partagé, lance php artisan storage:link, met en cache la configuration, les routes, les vues et les événements, lance php artisan migrate --force et garde les 5 dernières versions. La recette WordPress partage wp-config.php et wp-content/uploads. Le reste vous revient ; parcourez cette liste avant le premier déploiement, puis avant les gros :

  • Réglages de production : shared/.env sur le serveur contient les bonnes valeurs de APP_KEY, APP_URL, base de données, e-mail, cache et file d'attente (WordPress : shared/wp-config.php).
  • Débogage désactivé : APP_ENV=production et APP_DEBUG=false (WordPress : WP_DEBUG vaut false).
  • Sauvegardes : sauvegardez la base de production juste avant un déploiement qui lance des migrations.
  • Migrations : relisez les nouvelles migrations ; elles s'exécutent automatiquement pendant le déploiement.
  • Workers de file d'attente : redémarrez-les après chaque déploiement pour qu'ils chargent le nouveau code. Ajoutez after('deploy:success', 'artisan:queue:restart'); à deploy.php, ou lancez php artisan horizon:terminate si vous utilisez Horizon.
  • Planificateur : ajoutez une fois * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 à la crontab de l'utilisateur de déploiement (WordPress : une vraie tâche cron qui appelle wp-cron.php).
  • HTTPS : le serveur web sert current/public (WordPress : current) en HTTPS avec un certificat valide.
  • Suivi des erreurs : connectez le projet avec rdev errors connect (ci-dessous) pour recevoir les erreurs de production.
  • Test rapide : après le déploiement, ouvrez la page d'accueil, connectez-vous, essayez le parcours principal et cherchez de nouvelles erreurs dans le journal. En cas de problème, vendor/bin/dep rollback production revient à la version précédente.

Approbations de déploiement avec l'offre Team

Avec l'offre Team, déployez avec rdev deploy run production au lieu d'appeler Deployer vous-même. rdev demande d'abord une approbation : le propriétaire et les administrateurs voient la demande sur la page Votre équipe et l'approuvent ou la rejettent, et le déploiement démarre dès que quelqu'un approuve. Une demande sur laquelle personne ne statue expire au bout d'une heure.

Suivi local des erreurs

Avec les offres Pro et Team, vous pouvez faire tourner GlitchTip, un outil open source de suivi des erreurs compatible avec les SDK Sentry, sur votre propre serveur. Il reste privé à votre tailnet à l'adresse https://rdev-errors.dev.test.

Installation : connectez-vous à votre serveur en root (ou avec votre utilisateur sudo) et lancez sudo rdev host errors setup. Cela installe GlitchTip à côté de votre environnement. Il fait tourner sa propre petite base PostgreSQL, utilise le Redis de votre environnement, a besoin d'environ 0,7 Go de mémoire (plafonné à 1 Go) et d'environ 1 Go de disque, et conserve les événements 30 jours. À la fin, la commande affiche l'e-mail et le mot de passe administrateur. Lancez rdev errors password à tout moment pour les revoir, ou relancez la commande d'installation pour mettre GlitchTip à jour et obtenir un nouveau mot de passe. Utilisez --email [email protected] pour choisir l'adresse administrateur. Les e-mails d'alerte de GlitchTip apparaissent sur votre page Mail (https://rdev-mail.dev.test). L'inscription est désactivée, vous seul pouvez vous connecter.

Connecter un projet : rdev errors connect my-shop crée un projet GlitchTip nommé d'après le dossier et écrit son DSN dans le projet :

  • Laravel : installe sentry/sentry-laravel et définit SENTRY_LARAVEL_DSN dans .env. Testez avec php artisan sentry:test.
  • WordPress : affiche les étapes pour le plugin WP Sentry et la ligne à ajouter à wp-config.php.
  • Autres langages : définit SENTRY_DSN dans .env. Ajoutez le SDK Sentry de votre langage, qui lit SENTRY_DSN ; assurez-vous que votre app charge .env, ou exportez la variable. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, puis Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, puis sentry_sdk.init(); Ruby: bundle add sentry-ruby, puis Sentry.init; Go: go get github.com/getsentry/sentry-go, puis sentry.Init(sentry.ClientOptions{}); .NET: dotnet add package Sentry; Java: io.sentry:sentry.

Pour envoyer les erreurs vers un autre GlitchTip ou vers Sentry, indiquez son DSN : rdev errors connect my-shop --dsn https://<key>@<host>/<id>.

Consulter les erreurs : ouvrez https://rdev-errors.dev.test, ou utilisez le bouton Errors de l'app laptop, et connectez-vous avec l'e-mail et le mot de passe administrateur. Tant que le suivi des erreurs n'est pas installé, la page explique comment l'installer. Les agents de code peuvent lire les erreurs non résolues d'un projet via l'outil MCP rdev_errors.

Suivi des erreurs

Envoyez les erreurs d'un projet vers GlitchTip ou Sentry, auto-hébergés ou dans leur cloud. Copiez le DSN de votre projet là-bas, puis exécutez :

rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
  • Laravel : installe sentry/sentry-laravel et définit SENTRY_LARAVEL_DSN dans .env. Vérifiez avec php artisan sentry:test.
  • WordPress : affiche les étapes pour le plugin WP Sentry et la ligne à ajouter à wp-config.php.
  • Autres projets : définit SENTRY_DSN dans .env pour le SDK Sentry de votre langage.