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/.envsur le serveur contient les bonnes valeurs deAPP_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=productionetAPP_DEBUG=false(WordPress :WP_DEBUGvautfalse). - 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 lancezphp artisan horizon:terminatesi 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 appellewp-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 productionrevient à 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-laravelet définitSENTRY_LARAVEL_DSNdans.env. Testez avecphp artisan sentry:test. - WordPress : affiche les étapes pour le plugin WP Sentry et la ligne à ajouter à
wp-config.php. - Autres langages : définit
SENTRY_DSNdans.env. Ajoutez le SDK Sentry de votre langage, qui litSENTRY_DSN; assurez-vous que votre app charge.env, ou exportez la variable. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, puisSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, puissentry_sdk.init(); Ruby:bundle add sentry-ruby, puisSentry.init; Go:go get github.com/getsentry/sentry-go, puissentry.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-laravelet définitSENTRY_LARAVEL_DSNdans.env. Vérifiez avecphp artisan sentry:test. - WordPress : affiche les étapes pour le plugin WP Sentry et la ligne à ajouter à
wp-config.php. - Autres projets : définit
SENTRY_DSNdans.envpour le SDK Sentry de votre langage.