En los planes Pro y Team, rdev te ayuda a publicar un proyecto en producción y a ver sus errores.
Desplegar con Deployer
rdev usa Deployer, la herramienta de despliegue estándar de PHP. En un proyecto Laravel o WordPress, ejecuta:
rdev deploy init myapp
Escribe un deploy.php a partir de la plantilla de rdev y añade Deployer a las dependencias de desarrollo del proyecto. Rellena el repositorio, el host de producción, el usuario SSH y la ruta, y luego despliega con vendor/bin/dep deploy production. El servidor de producción necesita PHP, Composer y un servidor web; el .env de producción (o wp-config.php) vive en ese servidor y nunca se despliega desde aquí.
Tu agente también conoce este flujo: pídele que configure el despliegue y rellenará deploy.php contigo antes del primer despliegue.
Lista de comprobación antes de desplegar
La receta de Laravel en deploy.php instala las dependencias de Composer, enlaza storage y el .env compartido, ejecuta php artisan storage:link, cachea la configuración, las rutas, las vistas y los eventos, ejecuta php artisan migrate --force y conserva las 5 últimas versiones. La receta de WordPress comparte wp-config.php y wp-content/uploads. El resto depende de ti; repasa esta lista antes del primer despliegue y antes de los grandes:
- Ajustes de producción:
shared/.enven el servidor tiene los valores correctos deAPP_KEY,APP_URL, base de datos, correo, caché y colas (WordPress:shared/wp-config.php). - Depuración desactivada:
APP_ENV=productionyAPP_DEBUG=false(WordPress:WP_DEBUGenfalse). - Copias de seguridad: haz una copia de la base de datos de producción justo antes de un despliegue que ejecute migraciones.
- Migraciones: revisa las migraciones nuevas; se ejecutan solas durante el despliegue.
- Workers de colas: reinícialos tras cada despliegue para que carguen el código nuevo. Añade
after('deploy:success', 'artisan:queue:restart');adeploy.php, o ejecutaphp artisan horizon:terminatesi usas Horizon. - Programador: añade una vez
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1al crontab del usuario de despliegue (WordPress: un cron real que llame awp-cron.php). - HTTPS: el servidor web sirve
current/public(WordPress:current) por HTTPS con un certificado válido. - Seguimiento de errores: conecta el proyecto con
rdev errors connect(abajo) para que te lleguen los errores de producción. - Prueba rápida: tras el despliegue, abre la página de inicio, inicia sesión, prueba el flujo principal y revisa el log en busca de errores nuevos. Si algo falla,
vendor/bin/dep rollback productionvuelve a la versión anterior.
Aprobaciones de despliegue en el plan Team
En el plan Team, despliega con rdev deploy run production en lugar de llamar tú mismo a Deployer. rdev pide aprobación primero: el propietario y los administradores ven la solicitud en la página Tu equipo y la aprueban o la rechazan, y el despliegue empieza en cuanto alguien la aprueba. Una solicitud sobre la que nadie decide caduca al cabo de una hora.
Seguimiento local de errores
En los planes Pro y Team puedes ejecutar GlitchTip, un rastreador de errores de código abierto compatible con los SDK de Sentry, en tu propio servidor. Permanece privado en tu tailnet en https://rdev-errors.dev.test.
Configúralo: conéctate a tu servidor como root (o tu usuario sudo) y ejecuta sudo rdev host errors setup. Esto instala GlitchTip junto a tu entorno. Ejecuta su propia base de datos PostgreSQL pequeña, usa el Redis de tu entorno, necesita unos 0,7 GB de memoria (limitado a 1 GB) y unos 1 GB de disco, y conserva los eventos 30 días. Al terminar muestra el correo y la contraseña de administrador. Ejecuta rdev errors password en cualquier momento para verlos de nuevo, o vuelve a ejecutar el comando de instalación para actualizar GlitchTip y obtener una contraseña nueva. Usa --email [email protected] para elegir la dirección de administrador. Los correos de alerta de GlitchTip aparecen en tu página Mail (https://rdev-mail.dev.test). El registro está desactivado, así que solo tú puedes iniciar sesión.
Conectar un proyecto: rdev errors connect my-shop crea un proyecto de GlitchTip con el nombre de la carpeta y escribe su DSN en el proyecto:
- Laravel: instala
sentry/sentry-laravely defineSENTRY_LARAVEL_DSNen.env. Pruébalo conphp artisan sentry:test. - WordPress: muestra los pasos del plugin WP Sentry y la línea que hay que añadir a
wp-config.php. - Otros lenguajes: define
SENTRY_DSNen.env. Añade el SDK de Sentry de tu lenguaje, que leeSENTRY_DSN; asegúrate de que tu app carga.env, o exporta la variable. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, luegoSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, luegosentry_sdk.init(); Ruby:bundle add sentry-ruby, luegoSentry.init; Go:go get github.com/getsentry/sentry-go, luegosentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Para enviar los errores a otro GlitchTip o a Sentry, pasa su DSN: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Ver los errores: abre https://rdev-errors.dev.test, o usa el botón Errors de la app del portátil, e inicia sesión con el correo y la contraseña de administrador. Mientras el seguimiento de errores no esté configurado, la página muestra cómo instalarlo. Los agentes de código pueden leer los errores sin resolver de un proyecto con la herramienta MCP rdev_errors.
Seguimiento de errores
Envía los errores de un proyecto a GlitchTip o a Sentry, autoalojados o en su nube. Copia el DSN de tu proyecto allí y luego ejecuta:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: instala
sentry/sentry-laravely defineSENTRY_LARAVEL_DSNen.env. Compruébalo conphp artisan sentry:test. - WordPress: muestra los pasos para el plugin WP Sentry y la línea que hay que añadir a
wp-config.php. - Otros proyectos: define
SENTRY_DSNen.envpara el SDK de Sentry de tu lenguaje.