Deploy, bản xem trước và quay lại phiên bản cũ.
Cách các lần push được đưa lên chạy thật, bản xem trước theo nhánh, quay lại phiên bản trước, lệnh release cho migration, cài đặt build, deploy hook, chế độ bảo trì và mật khẩu cho bản xem trước.
Khi ứng dụng đã chạy, bạn hiếm khi cần đến bảng điều khiển để cập nhật: chỉ cần push lên nhánh và phiên bản mới sẽ tự được đưa lên. Bài viết này nói về mọi thứ xung quanh việc đó — tab Deploy, Bản xem trước, tab Tiến trình và một vài tùy chọn trong Cài đặt.
Tự động deploy sau mỗi lần push
Mỗi lần push lên nhánh của ứng dụng, commit mới nhất sẽ được build và deploy. Phiên bản mới khởi động song song với phiên bản đang chạy và chỉ nhận khách truy cập khi đã phản hồi; nếu nó không khởi động được, phiên bản trước vẫn tiếp tục chạy và chúng tôi báo cho bạn qua email (và Telegram, nếu bạn đã kết nối).
Lần push được thực hiện khi một bản build khác vẫn đang chờ trong hàng đợi sẽ gộp vào bản build đó, nên nhiều lần push liên tiếp không tạo ra hàng đợi dài.
Bạn có thể tắt tính năng này trong Cài đặt → Deploy mỗi lần push. Khi tắt, bạn deploy từ bảng điều khiển, API hoặc deploy hook.
Deploy từ bảng điều khiển
Tab Deploy liệt kê mọi lần deploy: nguồn khởi chạy (push, bảng điều khiển, quay lại phiên bản cũ, deploy hook), commit, thời gian thực hiện và trạng thái. Bấm vào một lần deploy để xem toàn bộ log build.
Deploy lại có hai lựa chọn:
- Build commit mới nhất — lấy mã mới nhất từ nhánh và build.
- Deploy lại phiên bản đang chạy — áp dụng các biến đã thay đổi mà không build lại. Dùng sau khi chỉnh sửa Biến.
Menu bên cạnh Mở có hai thao tác này cùng với Khởi động lại.
Quay lại phiên bản cũ
Bạn có thể quay lại bất kỳ phiên bản nào trong 5 phiên bản thành công gần nhất. Trong tab Deploy, bấm Quay lại trên phiên bản bạn muốn và xác nhận. Phiên bản cũ được khởi động song song với phiên bản hiện tại và tiếp quản khi đã phản hồi — không có bản build mới.
Việc quay lại phiên bản cũ không hoàn tác thay đổi trong cơ sở dữ liệu. Nếu một bản phát hành đã thay đổi cấu trúc cơ sở dữ liệu, hãy khôi phục cả cơ sở dữ liệu — xem Cơ sở dữ liệu.
Bản xem trước cho các nhánh
Mỗi lần push lên bất kỳ nhánh nào khác sẽ có bản xem trước riêng — một địa chỉ riêng để bạn kiểm tra thay đổi trước khi đưa lên chạy thật. Mở chúng trong tab Bản xem trước.
- Tối đa 3 bản xem trước cùng lúc, đã bao gồm trong giá.
- Bản xem trước không có lần push mới trong 7 ngày sẽ bị xóa. Nó sẽ được tạo lại ở lần push tiếp theo lên nhánh đó.
- Bản xem trước chỉ nhận các biến dành cho chúng — xem Biến môi trường.
- Bản xem trước chỉ được tạo cho dịch vụ chính của dự án, không cho các dịch vụ khác.
Mật khẩu cho bản xem trước
Trong tab Bản xem trước, Mật khẩu cho bản xem trước → Yêu cầu mật khẩu. Nhập tên người dùng và mật khẩu (tối thiểu 8 ký tự). Từ đó, chỉ người có mật khẩu mới mở được bản xem trước; bản thân ứng dụng vẫn mở cho mọi người.
Lệnh release (migration)
Tab Tiến trình → Lệnh release. Lệnh này chạy một lần trong mỗi lần deploy, trước khi phiên bản mới nhận khách truy cập — thường là migration cơ sở dữ liệu. Nếu lệnh thất bại, quá trình deploy dừng lại và phiên bản hiện tại vẫn tiếp tục chạy, nên migration lỗi không bao giờ ảnh hưởng tới khách truy cập.
Chúng tôi gợi ý lệnh cho các framework có sẵn lệnh này:
| Framework | Lệnh release khuyến nghị |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Dùng lệnh khuyến nghị sẽ giữ lệnh này; bạn cũng có thể nhập lệnh riêng hoặc chọn Không có. Thay đổi được áp dụng từ lần deploy tiếp theo.
Cài đặt build
Cài đặt → Cài đặt build cho phép bạn thay đổi những gì chúng tôi đã nhận diện:
- Lệnh cài đặt — ví dụ
npm ci - Lệnh build — ví dụ
npm run build - Lệnh khởi động — lệnh khởi động ứng dụng của bạn. Ứng dụng phải lắng nghe trên cổng trong
$PORT. - Thư mục đầu ra — với website tĩnh, thư mục chứa các tệp đã build.
- Thư mục dự án — với repository chứa nhiều dự án.
Để trống một trường để dùng giá trị chúng tôi đã nhận diện. Lần deploy tiếp theo sẽ được build với cài đặt mới; Build ngay bắt đầu ngay lập tức.
Cài đặt cũng chứa Nhánh được deploy.
Deploy hook
Cài đặt → Deploy hook → Tạo hook. Deploy hook là một địa chỉ riêng tư: khi một dịch vụ khác gửi yêu cầu POST tới đó, commit mới nhất trên nhánh của bạn sẽ được build và deploy. Trường hợp dùng điển hình là CMS build lại website sau khi bạn xuất bản.
curl -X POST "<địa chỉ hook từ bảng điều khiển>"- Địa chỉ chỉ hiển thị một lần — hãy sao chép khi tạo hook. Bất kỳ ai có địa chỉ này đều có thể bắt đầu deploy, vì vậy hãy giữ bí mật.
- Tối đa 10 lần deploy mỗi giờ cho mỗi hook. Lệnh gọi đến khi một bản build vẫn đang chờ sẽ gộp vào bản build đó.
- Thu hồi vô hiệu hóa địa chỉ ngay lập tức; các dịch vụ gọi tới nó sẽ cần địa chỉ mới.
Chế độ bảo trì
Cài đặt → Chế độ bảo trì → Hiển thị trang bảo trì. Khách truy cập sẽ thấy một trang ngắn với thông báo của bạn thay cho ứng dụng; để trống thông báo để hiển thị «Chúng tôi đang cải thiện một vài điều. Vui lòng quay lại sau ít phút.»
Bản thân ứng dụng vẫn tiếp tục chạy, nên bạn có thể kiểm tra mọi thứ trước khi mở lại. Liên kết riêng cho bạn hiển thị ứng dụng như bình thường trên thiết bị mở liên kết, trong 12 giờ. Liên kết mới tạo một liên kết khác; liên kết cũ ngừng hoạt động.
Tắt công tắc để mở lại ứng dụng cho khách truy cập.
Thông báo về deploy
Chúng tôi gửi email cho bạn (và tin nhắn Telegram, nếu bạn đã kết nối) khi một lần deploy không hoàn tất. Để gửi sự kiện cho cả đội của bạn — phiên bản mới đã chạy, deploy không hoàn tất, dịch vụ dừng hoặc hoạt động trở lại, mức dùng bộ nhớ hoặc CPU cao, sao lưu hay ổ đĩa cơ sở dữ liệu — hãy thêm Slack, Discord hoặc webhook riêng trong Cài đặt → Thông báo cho đội của bạn. Tin nhắn webhook là JSON được ký bằng một secret chỉ hiển thị một lần, trong header X-Rivervo-Signature.