Gõ ít nhất hai chữ cái để tìm trong mọi trang tài liệu.

↑ ↓ để di chuyển ↵ để mở esc để đóng

Sử dụng rdev

Triển khai và theo dõi lỗi

Ở các gói Pro và Team, rdev giúp bạn đưa một dự án lên production và xem các lỗi của nó.

Triển khai với Deployer

rdev dùng Deployer, công cụ triển khai tiêu chuẩn cho PHP. Trong một dự án Laravel hoặc WordPress, hãy chạy:

rdev deploy init myapp

Nó ghi một deploy.php từ mẫu của rdev và thêm Deployer vào các dev dependency của dự án. Hãy điền kho mã, máy chủ production, người dùng SSH và đường dẫn, rồi triển khai bằng vendor/bin/dep deploy production. Máy chủ production cần PHP, Composer và một máy chủ web; .env (hoặc wp-config.php) của production nằm trên máy chủ đó và không bao giờ được triển khai từ đây.

Agent của bạn cũng biết quy trình này: hãy nhờ nó thiết lập triển khai, và nó cùng bạn điền deploy.php trước lần triển khai đầu tiên.

Danh sách kiểm tra trước khi deploy

Công thức Laravel trong deploy.php cài các phụ thuộc Composer, liên kết storage và .env dùng chung, chạy php artisan storage:link, cache cấu hình, route, view và event, chạy php artisan migrate --force và giữ 5 bản phát hành gần nhất. Công thức WordPress dùng chung wp-config.php và wp-content/uploads. Phần còn lại do bạn đảm nhận; hãy rà danh sách này trước lần deploy đầu tiên và trước các lần deploy lớn:

  • Cấu hình production: shared/.env trên máy chủ có đúng APP_KEY, APP_URL, cơ sở dữ liệu, mail, cache và hàng đợi (WordPress: shared/wp-config.php).
  • Tắt debug: APP_ENV=production và APP_DEBUG=false (WordPress: WP_DEBUG là false).
  • Sao lưu: sao lưu cơ sở dữ liệu production ngay trước một lần deploy có chạy migration.
  • Migration: đọc qua các migration mới; chúng tự chạy trong lúc deploy.
  • Queue worker: khởi động lại sau mỗi lần deploy để chúng nạp mã mới. Thêm after('deploy:success', 'artisan:queue:restart'); vào deploy.php, hoặc chạy php artisan horizon:terminate nếu bạn dùng Horizon.
  • Bộ lập lịch: thêm một lần * * * * * cd /var/www/myapp/current && php artisan schedule:run >> /dev/null 2>&1 vào crontab của người dùng deploy (WordPress: một cron thật gọi wp-cron.php).
  • HTTPS: máy chủ web phục vụ current/public (WordPress: current) qua HTTPS với chứng chỉ hợp lệ.
  • Theo dõi lỗi: kết nối dự án bằng rdev errors connect (bên dưới) để lỗi production đến được bạn.
  • Kiểm tra nhanh: sau khi deploy, mở trang chủ, đăng nhập, thử luồng chính và xem log có lỗi mới không. Nếu có vấn đề, vendor/bin/dep rollback production quay lại bản phát hành trước.

Phê duyệt triển khai ở gói Team

Ở gói Team, hãy triển khai bằng rdev deploy run production thay vì tự gọi Deployer. rdev xin phê duyệt trước: chủ sở hữu và các quản trị viên thấy yêu cầu trên trang Nhóm của bạn và phê duyệt hoặc từ chối nó, và lượt triển khai bắt đầu ngay khi có người phê duyệt. Một yêu cầu không ai quyết định sẽ hết hạn sau một giờ.

Theo dõi lỗi cục bộ

Ở gói Pro và Team, bạn có thể chạy GlitchTip, một công cụ theo dõi lỗi mã nguồn mở tương thích với SDK của Sentry, trên chính máy chủ của bạn. Nó chỉ riêng tư trong tailnet của bạn tại https://rdev-errors.dev.test.

Thiết lập: kết nối tới máy chủ bằng root (hoặc người dùng sudo của bạn) và chạy sudo rdev host errors setup. Lệnh này cài GlitchTip cạnh môi trường của bạn. Nó chạy cơ sở dữ liệu PostgreSQL nhỏ của riêng mình, dùng Redis của môi trường, cần khoảng 0,7 GB bộ nhớ (giới hạn 1 GB) và khoảng 1 GB ổ đĩa, và giữ sự kiện trong 30 ngày. Khi xong, lệnh in ra email và mật khẩu quản trị. Chạy rdev errors password bất cứ lúc nào để xem lại, hoặc chạy lại lệnh thiết lập để cập nhật GlitchTip và nhận mật khẩu mới. Dùng --email [email protected] để chọn địa chỉ quản trị. Email cảnh báo của GlitchTip xuất hiện trên trang Mail của bạn (https://rdev-mail.dev.test). Đăng ký đã bị tắt nên chỉ mình bạn đăng nhập được.

Kết nối dự án: rdev errors connect my-shop tạo một dự án GlitchTip đặt theo tên thư mục và ghi DSN của nó vào dự án:

  • Laravel: cài sentry/sentry-laravel và đặt SENTRY_LARAVEL_DSN trong .env. Kiểm tra bằng php artisan sentry:test.
  • WordPress: in các bước cho plugin WP Sentry và dòng cần thêm vào wp-config.php.
  • Ngôn ngữ khác: đặt SENTRY_DSN trong .env. Hãy thêm SDK Sentry của ngôn ngữ bạn dùng, SDK này đọc SENTRY_DSN; đảm bảo ứng dụng nạp .env, hoặc export biến đó. PHP: composer require sentry/sentry; Node.js: npm install @sentry/node, rồi Sentry.init({ dsn: process.env.SENTRY_DSN }); Python: pip install sentry-sdk, rồi sentry_sdk.init(); Ruby: bundle add sentry-ruby, rồi Sentry.init; Go: go get github.com/getsentry/sentry-go, rồi sentry.Init(sentry.ClientOptions{}); .NET: dotnet add package Sentry; Java: io.sentry:sentry.

Để gửi lỗi tới một GlitchTip khác hoặc tới Sentry, hãy truyền DSN của nó: rdev errors connect my-shop --dsn https://<key>@<host>/<id>.

Xem lỗi: mở https://rdev-errors.dev.test, hoặc dùng nút Errors trong ứng dụng laptop, rồi đăng nhập bằng email và mật khẩu quản trị. Khi chưa thiết lập theo dõi lỗi, trang sẽ hướng dẫn cách cài. Các agent lập trình có thể đọc lỗi chưa xử lý của dự án qua công cụ MCP rdev_errors.

Theo dõi lỗi

Gửi các lỗi của một dự án đến GlitchTip hoặc Sentry, tự lưu trữ hoặc trên đám mây của họ. Sao chép DSN từ dự án của bạn ở đó, rồi chạy:

rdev errors connect myapp --dsn https://<key>@<host>/<project-id>
  • Laravel: cài sentry/sentry-laravel và đặt SENTRY_LARAVEL_DSN trong .env. Kiểm tra bằng php artisan sentry:test.
  • WordPress: in ra các bước cho plugin WP Sentry và dòng cần thêm vào wp-config.php.
  • Các dự án khác: đặt SENTRY_DSN trong .env cho Sentry SDK của ngôn ngữ của bạn.