Ở 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/.envtrên máy chủ có đúngAPP_KEY,APP_URL, cơ sở dữ liệu, mail, cache và hàng đợi (WordPress:shared/wp-config.php). - Tắt debug:
APP_ENV=productionvàAPP_DEBUG=false(WordPress:WP_DEBUGlà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àodeploy.php, hoặc chạyphp artisan horizon:terminatenế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>&1vào crontab của người dùng deploy (WordPress: một cron thật gọiwp-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 productionquay 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-laravelvà đặtSENTRY_LARAVEL_DSNtrong.env. Kiểm tra bằngphp 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_DSNtrong.env. Hãy thêm SDK Sentry của ngôn ngữ bạn dùng, SDK này đọcSENTRY_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ồiSentry.init({ dsn: process.env.SENTRY_DSN }); Python:pip install sentry-sdk, rồisentry_sdk.init(); Ruby:bundle add sentry-ruby, rồiSentry.init; Go:go get github.com/getsentry/sentry-go, rồisentry.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-laravelvà đặtSENTRY_LARAVEL_DSNtrong.env. Kiểm tra bằngphp 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_DSNtrong.envcho Sentry SDK của ngôn ngữ của bạn.