Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Deploy e tracciamento errori

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/.env sul server ha i valori giusti di APP_KEY, APP_URL, database, mail, cache e code (WordPress: shared/wp-config.php).
  • Debug spento: APP_ENV=production e APP_DEBUG=false (WordPress: WP_DEBUG a false).
  • 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'); a deploy.php, oppure esegui php artisan horizon:terminate se usi Horizon.
  • Scheduler: aggiungi una volta * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 al crontab dell'utente di deploy (WordPress: un vero cron che chiama wp-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 production torna 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-laravel e imposta SENTRY_LARAVEL_DSN in .env. Provalo con php 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_DSN in .env. Aggiungi l'SDK Sentry del tuo linguaggio, che legge SENTRY_DSN; assicurati che la tua app carichi .env, oppure esporta la variabile. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, poi Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, poi sentry_sdk.init(); Ruby: bundle add sentry-ruby, poi Sentry.init; Go: go get github.com/getsentry/sentry-go, poi sentry.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-laravel e imposta SENTRY_LARAVEL_DSN in .env. Verificalo con php 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_DSN in .env per l'SDK Sentry del tuo linguaggio.