Nei piani Pro e Team rdev ti aiuta a pubblicare un progetto in produzione e a vederne gli errori.
Deploy con Deployer
rdev usa Deployer, lo strumento di deploy standard per PHP. In un progetto Laravel o WordPress, esegui:
rdev deploy init myapp
Scrive un deploy.php dal template di rdev e aggiunge Deployer alle dipendenze di sviluppo del progetto. Compila il repository, l'host di produzione, l'utente SSH e il percorso, poi fai il deploy con vendor/bin/dep deploy production. Il server di produzione ha bisogno di PHP, Composer e un server web; il .env di produzione (o wp-config.php) vive su quel server e non viene mai distribuito da qui.
Anche il tuo agente conosce questo flusso: chiedigli di configurare il deploy e compilerà deploy.php insieme a te prima del primo deploy.
Checklist prima del deploy
La ricetta Laravel in deploy.php installa le dipendenze Composer, collega storage e il .env condiviso, esegue php artisan storage:link, mette in cache configurazione, route, view ed eventi, esegue php artisan migrate --force e conserva le ultime 5 release. La ricetta WordPress condivide wp-config.php e wp-content/uploads. Il resto spetta a te; scorri questa lista prima del primo deploy e prima di quelli importanti:
- Impostazioni di produzione:
shared/.envsul server ha i valori giusti diAPP_KEY,APP_URL, database, mail, cache e code (WordPress:shared/wp-config.php). - Debug spento:
APP_ENV=productioneAPP_DEBUG=false(WordPress:WP_DEBUGafalse). - Backup: fai un backup del database di produzione subito prima di un deploy che esegue migrazioni.
- Migrazioni: rileggi le nuove migrazioni; vengono eseguite in automatico durante il deploy.
- Worker delle code: riavviali dopo ogni deploy perché carichino il nuovo codice. Aggiungi
after('deploy:success', 'artisan:queue:restart');adeploy.php, oppure eseguiphp artisan horizon:terminatese usi Horizon. - Scheduler: aggiungi una volta
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1al crontab dell'utente di deploy (WordPress: un vero cron che chiamawp-cron.php). - HTTPS: il web server serve
current/public(WordPress:current) in HTTPS con un certificato valido. - Tracciamento errori: collega il progetto con
rdev errors connect(sotto) così gli errori di produzione ti raggiungono. - Smoke test: dopo il deploy apri la home, accedi, prova il flusso principale e controlla il log per nuovi errori. Se qualcosa non va,
vendor/bin/dep rollback productiontorna alla release precedente.
Approvazioni dei deploy nel piano Team
Nel piano Team, fai il deploy con rdev deploy run production invece di chiamare Deployer direttamente. rdev chiede prima l'approvazione: il proprietario e gli amministratori vedono la richiesta nella pagina Il tuo team e la approvano o la rifiutano, e il deploy parte non appena qualcuno approva. Una richiesta su cui nessuno decide scade dopo un'ora.
Tracciamento locale degli errori
Con i piani Pro e Team puoi eseguire GlitchTip, un tracker di errori open source compatibile con gli SDK di Sentry, sul tuo server. Resta privato nella tua tailnet su https://rdev-errors.dev.test.
Configurazione: collegati al server come root (o con il tuo utente sudo) ed esegui sudo rdev host errors setup. Installa GlitchTip accanto al tuo ambiente. Esegue un proprio piccolo database PostgreSQL, usa il Redis del tuo ambiente, richiede circa 0,7 GB di memoria (limitata a 1 GB) e circa 1 GB di disco, e conserva gli eventi per 30 giorni. Al termine stampa email e password dell'amministratore. Esegui rdev errors password in qualsiasi momento per rivederle, oppure riesegui il comando di configurazione per aggiornare GlitchTip e ottenere una nuova password. Usa --email [email protected] per scegliere l'indirizzo dell'amministratore. Le email di avviso di GlitchTip compaiono nella tua pagina Mail (https://rdev-mail.dev.test). La registrazione è disattivata, quindi solo tu puoi accedere.
Collegare un progetto: rdev errors connect my-shop crea un progetto GlitchTip con il nome della cartella e scrive il suo DSN nel progetto:
- Laravel: installa
sentry/sentry-laravele impostaSENTRY_LARAVEL_DSNin.env. Provalo conphp artisan sentry:test. - WordPress: stampa i passaggi per il plugin WP Sentry e la riga da aggiungere a
wp-config.php. - Altri linguaggi: imposta
SENTRY_DSNin.env. Aggiungi l'SDK Sentry del tuo linguaggio, che leggeSENTRY_DSN; assicurati che la tua app carichi.env, oppure esporta la variabile. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, poiSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, poisentry_sdk.init(); Ruby:bundle add sentry-ruby, poiSentry.init; Go:go get github.com/getsentry/sentry-go, poisentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Per inviare gli errori a un altro GlitchTip o a Sentry, passa il suo DSN: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Vedere gli errori: apri https://rdev-errors.dev.test, oppure usa il pulsante Errors nell'app per laptop, e accedi con email e password dell'amministratore. Finché il tracciamento degli errori non è configurato, la pagina mostra come installarlo. Gli agenti di codice possono leggere gli errori non risolti di un progetto con lo strumento MCP rdev_errors.
Tracciamento errori
Invia gli errori di un progetto a GlitchTip o Sentry, self-hosted o nel loro cloud. Copia il DSN dal tuo progetto lì, poi esegui:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: installa
sentry/sentry-laravele impostaSENTRY_LARAVEL_DSNin.env. Verificalo conphp artisan sentry:test. - WordPress: stampa i passaggi per il plugin WP Sentry e la riga da aggiungere a
wp-config.php. - Altri progetti: imposta
SENTRY_DSNin.envper l'SDK Sentry del tuo linguaggio.