Nos planos Pro e Team, o rdev ajuda você a publicar um projeto em produção e a ver os erros dele.
Deploy com o Deployer
O rdev usa o Deployer, a ferramenta de deploy padrão do PHP. Em um projeto Laravel ou WordPress, execute:
rdev deploy init myapp
Ele escreve um deploy.php a partir do template do rdev e adiciona o Deployer às dependências de desenvolvimento do projeto. Preencha o repositório, o host de produção, o usuário SSH e o caminho, depois faça o deploy com vendor/bin/dep deploy production. O servidor de produção precisa de PHP, Composer e um servidor web; o .env de produção (ou o wp-config.php) fica nesse servidor e nunca é publicado a partir daqui.
O seu agente também conhece esse fluxo: peça a ele para configurar o deploy, e ele preenche o deploy.php com você antes do primeiro deploy.
Checklist antes do deploy
A receita Laravel em deploy.php instala as dependências do Composer, liga storage e o .env compartilhado, executa php artisan storage:link, faz cache da configuração, rotas, views e eventos, executa php artisan migrate --force e mantém as últimas 5 versões. A receita WordPress compartilha wp-config.php e wp-content/uploads. O resto é com você; passe por esta lista antes do primeiro deploy e antes dos grandes:
- Configuração de produção:
shared/.envno servidor tem os valores certos deAPP_KEY,APP_URL, banco de dados, e-mail, cache e fila (WordPress:shared/wp-config.php). - Debug desligado:
APP_ENV=productioneAPP_DEBUG=false(WordPress:WP_DEBUGcomofalse). - Backups: faça um backup do banco de produção logo antes de um deploy que roda migrações.
- Migrações: leia as migrações novas; elas rodam sozinhas durante o deploy.
- Workers de fila: reinicie-os após cada deploy para carregarem o código novo. Adicione
after('deploy:success', 'artisan:queue:restart');aodeploy.php, ou executephp artisan horizon:terminatese usar Horizon. - Agendador: adicione uma vez
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1ao crontab do usuário de deploy (WordPress: um cron real que chamawp-cron.php). - HTTPS: o servidor web serve
current/public(WordPress:current) por HTTPS com um certificado válido. - Rastreamento de erros: conecte o projeto com
rdev errors connect(abaixo) para receber os erros de produção. - Teste rápido: após o deploy, abra a página inicial, entre, teste o fluxo principal e veja se há erros novos no log. Se algo der errado,
vendor/bin/dep rollback productionvolta para a versão anterior.
Aprovações de deploy no plano Team
No plano Team, faça o deploy com rdev deploy run production em vez de chamar o Deployer diretamente. O rdev pede aprovação antes: o proprietário e os administradores veem a solicitação na página Sua equipe e a aprovam ou rejeitam, e o deploy começa assim que alguém aprova. Uma solicitação sobre a qual ninguém decide expira após uma hora.
Rastreamento local de erros
Nos planos Pro e Team você pode executar o GlitchTip, um rastreador de erros de código aberto compatível com os SDKs do Sentry, no seu próprio servidor. Ele fica privado na sua tailnet em https://rdev-errors.dev.test.
Configure: conecte-se ao seu servidor como root (ou seu usuário sudo) e execute sudo rdev host errors setup. Isso instala o GlitchTip ao lado do seu ambiente. Ele roda seu próprio pequeno banco PostgreSQL, usa o Redis do seu ambiente, precisa de cerca de 0,7 GB de memória (limitado a 1 GB) e cerca de 1 GB de disco, e guarda os eventos por 30 dias. Ao terminar, mostra o e-mail e a senha de administrador. Execute rdev errors password a qualquer momento para vê-los de novo, ou execute o comando de instalação outra vez para atualizar o GlitchTip e obter uma nova senha. Use --email [email protected] para escolher o endereço de administrador. Os e-mails de alerta do GlitchTip aparecem na sua página Mail (https://rdev-mail.dev.test). O cadastro está desativado, então só você pode entrar.
Conectar um projeto: rdev errors connect my-shop cria um projeto do GlitchTip com o nome da pasta e grava o DSN dele no projeto:
- Laravel: instala
sentry/sentry-laravele defineSENTRY_LARAVEL_DSNno.env. Teste comphp artisan sentry:test. - WordPress: mostra os passos do plugin WP Sentry e a linha a adicionar ao
wp-config.php. - Outras linguagens: define
SENTRY_DSNno.env. Adicione o SDK do Sentry da sua linguagem, que lêSENTRY_DSN; garanta que sua app carregue o.env, ou exporte a variável. PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, depoisSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, depoissentry_sdk.init(); Ruby:bundle add sentry-ruby, depoisSentry.init; Go:go get github.com/getsentry/sentry-go, depoissentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
Para enviar os erros a outro GlitchTip ou ao Sentry, passe o DSN dele: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.
Ver os erros: abra https://rdev-errors.dev.test, ou use o botão Errors do app do laptop, e entre com o e-mail e a senha de administrador. Enquanto o rastreamento de erros não estiver configurado, a página mostra como instalá-lo. Agentes de código podem ler os erros não resolvidos de um projeto pela ferramenta MCP rdev_errors.
Rastreamento de erros
Envie os erros de um projeto para o GlitchTip ou o Sentry, hospedados por você ou na nuvem deles. Copie o DSN do seu projeto lá e execute:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: instala o
sentry/sentry-laravele define oSENTRY_LARAVEL_DSNno.env. Verifique comphp artisan sentry:test. - WordPress: imprime os passos do plugin WP Sentry e a linha a adicionar ao
wp-config.php. - Outros projetos: define o
SENTRY_DSNno.envpara o SDK do Sentry da sua linguagem.