在 Pro 和 Team 套餐中,rdev 可帮助您将项目发布到生产环境并查看其错误。
使用 Deployer 部署
rdev 使用 Deployer,这是 PHP 的标准部署工具。在 Laravel 或 WordPress 项目中运行:
rdev deploy init myapp
它会根据 rdev 的模板生成 deploy.php,并将 Deployer 添加到项目的开发依赖中。填写仓库、生产主机、SSH 用户和路径,然后使用 vendor/bin/dep deploy production 部署。生产服务器需要 PHP、Composer 和 Web 服务器;生产环境的 .env(或 wp-config.php)保存在该服务器上,绝不会从这里部署。
您的智能体也了解这一流程:请它设置部署,它会在首次部署前与您一起填写 deploy.php。
部署前检查清单
deploy.php 中的 Laravel 配方会安装 Composer 依赖,链接 storage 和共享的 .env,运行 php artisan storage:link,缓存配置、路由、视图和事件,运行 php artisan migrate --force,并保留最近 5 个版本。WordPress 配方共享 wp-config.php 和 wp-content/uploads。其余事项需要你自己确认;首次部署前和大型部署前请过一遍这份清单:
- 生产配置: 服务器上的
shared/.env中有正确的APP_KEY、APP_URL、数据库、邮件、缓存和队列配置(WordPress:shared/wp-config.php)。 - 关闭调试:
APP_ENV=production且APP_DEBUG=false(WordPress:WP_DEBUG为false)。 - 备份: 在会运行迁移的部署之前,先备份生产数据库。
- 迁移: 读一遍新的迁移;它们会在部署时自动运行。
- 队列 worker: 每次部署后重启,让它们加载新代码。在
deploy.php中加入after('deploy:success', 'artisan:queue:restart');,或在使用 Horizon 时运行php artisan horizon:terminate。 - 调度器: 在部署用户的 crontab 中添加一次
* * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1(WordPress:一个调用wp-cron.php的真实 cron 任务)。 - HTTPS: Web 服务器通过 HTTPS 和有效证书提供
current/public(WordPress:current)。 - 错误追踪: 用
rdev errors connect(见下文)连接项目,让生产错误能通知到你。 - 冒烟测试: 部署后打开首页、登录、走一遍主要流程,并检查日志中是否有新错误。如有问题,
vendor/bin/dep rollback production会切回上一个版本。
Team 套餐中的部署审批
在 Team 套餐中,请使用 rdev deploy run production 部署,而不是自己调用 Deployer。rdev 会先请求批准:所有者和管理员会在您的团队页面看到该请求并批准或拒绝,一旦有人批准,部署便会立即开始。无人处理的请求会在一小时后过期。
本地错误跟踪
在 Pro 和 Team 套餐中,你可以在自己的服务器上运行 GlitchTip,这是一款兼容 Sentry SDK 的开源错误跟踪工具。它只在你的 tailnet 内可见,地址是 https://rdev-errors.dev.test。
设置:以 root(或你的 sudo 用户)连接服务器,运行 sudo rdev host errors setup。这会把 GlitchTip 安装在你的环境旁边。它运行自己的小型 PostgreSQL 数据库,使用环境中的 Redis,需要约 0.7 GB 内存(上限 1 GB)和约 1 GB 磁盘,事件保留 30 天。完成后会打印管理员邮箱和密码。随时运行 rdev errors password 可再次查看;重新运行设置命令可更新 GlitchTip 并获得新密码。用 --email [email protected] 指定管理员邮箱。GlitchTip 的告警邮件会出现在你的 Mail 页面(https://rdev-mail.dev.test)。注册已关闭,只有你可以登录。
连接项目:rdev errors connect my-shop 会以文件夹名创建一个 GlitchTip 项目,并把它的 DSN 写入项目:
- Laravel: 安装
sentry/sentry-laravel,并在.env中设置SENTRY_LARAVEL_DSN。用php artisan sentry:test测试。 - WordPress: 打印 WP Sentry 插件的步骤,以及要添加到
wp-config.php的那一行。 - 其他语言: 在
.env中设置SENTRY_DSN。添加你所用语言的 Sentry SDK(它会读取SENTRY_DSN),并确保应用加载.env,或导出该变量。PHP:composer require sentry/sentry; Node.js:npm install @sentry/node, 然后Sentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, 然后sentry_sdk.init(); Ruby:bundle add sentry-ruby, 然后Sentry.init; Go:go get github.com/getsentry/sentry-go, 然后sentry.Init(sentry.ClientOptions{}); .NET:dotnet add package Sentry; Java:io.sentry:sentry.
若要把错误发送到另一个 GlitchTip 或 Sentry,请传入它的 DSN:rdev errors connect my-shop --dsn https://<key>@<host>/<id>。
查看错误:打开 https://rdev-errors.dev.test,或使用笔记本应用中的 Errors 按钮,并用管理员邮箱和密码登录。在错误跟踪设置完成之前,页面会显示如何安装。编码代理可以通过 rdev_errors MCP 工具读取项目的未解决错误。
错误跟踪
将项目的错误发送到 GlitchTip 或 Sentry,自托管或使用其云服务均可。在那里复制您项目的 DSN,然后运行:
rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
- Laravel: 安装
sentry/sentry-laravel并在.env中设置SENTRY_LARAVEL_DSN。使用php artisan sentry:test检查。 - WordPress: 打印 WP Sentry 插件的步骤,以及要添加到
wp-config.php的行。 - 其他项目: 在
.env中为您所用语言的 Sentry SDK 设置SENTRY_DSN。