Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Deploy e rastreamento de erros

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/.env no servidor tem os valores certos de APP_KEY, APP_URL, banco de dados, e-mail, cache e fila (WordPress: shared/wp-config.php).
  • Debug desligado: APP_ENV=production e APP_DEBUG=false (WordPress: WP_DEBUG como false).
  • 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'); ao deploy.php, ou execute php artisan horizon:terminate se usar Horizon.
  • Agendador: adicione uma vez * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 ao crontab do usuário de deploy (WordPress: um cron real que chama wp-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 production volta 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-laravel e define SENTRY_LARAVEL_DSN no .env. Teste com php artisan sentry:test.
  • WordPress: mostra os passos do plugin WP Sentry e a linha a adicionar ao wp-config.php.
  • Outras linguagens: define SENTRY_DSN no .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, depois Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, depois sentry_sdk.init(); Ruby: bundle add sentry-ruby, depois Sentry.init; Go: go get github.com/getsentry/sentry-go, depois sentry.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-laravel e define o SENTRY_LARAVEL_DSN no .env. Verifique com php 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_DSN no .env para o SDK do Sentry da sua linguagem.