Deploy app
Deploy chạy check trên project rồi đưa giao diện và API của app lên <id>.manh.run cùng một lúc. Agent ghi file xong, app không tự deploy.
App chạy thật chỉ thay đổi khi có lệnh deploy, nên người dùng của app không bao giờ gặp bản đang viết dở. Trong lúc agent sửa file, bạn xem bản nháp ở khung xem trước trong bảng điều khiển.
Hai cách deploy
Cả hai cách chạy cùng một quy trình:
- Bảo agent deploy, ví dụ: “Chạy check rồi deploy app Duyệt mua sắm.” Agent gọi công cụ
deploy. - Bấm Deploy ở đầu trang project trong bảng điều khiển. Mục nào của project cũng có nút này.
Deploy làm gì
Mỗi lần deploy, manh.run làm lần lượt các bước sau:
- Chạy
checkđủ bốn lớp, gồm cả kiểm kiểu. Còn lỗi thì manh.run không deploy mà trả danh sách lỗi để agent sửa. App đang chạy giữ nguyên. - Build giao diện: mọi file
.tsxđược biên dịch thành file tĩnh. Trang công khai có HTML dựng sẵn mangexport const metacủa trang đó (tiêu đề, mô tả, ảnh xem trước khi chia sẻ link). - Đóng gói backend: handler, middleware, cron, job, bảng, repository và các file chúng import gộp thành một khối.
- Áp schema từ các file
*.table.tsvào database SQLite riêng của app. - Đưa giao diện và API lên cùng lúc, cập nhật các việc chạy định kỳ (cron) rồi chờ bản mới trả lời được. Request kế tiếp đã gặp bản mới.
Một lần deploy thường mất 3–10 giây, lần đầu lâu hơn. Lỗi biên dịch giao diện hay lỗi đóng gói backend làm deploy thất bại kèm file:dòng, trước khi app thật bị đổi gì.
Chỉ lỗi kiểu (TypeScript) là bỏ qua được: agent gọi deploy với force: true và reason nói vì sao lỗi đó không làm hỏng app. Lỗi cú pháp, luật cấm và luật hợp đồng thì không bỏ qua được. Xem Quy tắc check.
Cây file nào đã từng deploy thành công thì không phải qua check nữa. Nhờ vậy, quay về checkpoint cũ rồi deploy luôn chạy được, kể cả khi check đã có quy tắc mới. Xem Rollback và checkpoint.
Test sau mỗi lần deploy
Khi agent deploy, manh.run chạy test trên một bản thử của app (cùng code, database riêng, không đụng dữ liệu thật) và trả kết quả ngay trong câu trả lời của deploy:
- Có
spec/acceptance.jsonthì chạy các test agent đã viết. - Chưa có thì chạy bộ kiểm cơ bản manh.run tự tạo từ file: mỗi vai trò mở trang chủ, các trang khác mở được, mọi danh sách trả 200 hoặc 403 chứ không phải 500.
Phần test chạy tối đa khoảng 30 giây, phần chưa kịp chạy được ghi là chưa chạy. Có test hỏng thì app vẫn lên, nhưng kết quả báo app chưa sẵn sàng bàn giao, và agent nên sửa rồi deploy lại.
Địa chỉ của app
App chạy ở <id>.manh.run, trong đó <id> là mã của project, ví dụ k7xq2mfp9dhw. manh.run cấp mã này khi tạo project và không đổi được. Muốn địa chỉ dễ nhớ thì gắn tên miền riêng. Giao diện nằm ở /, API nằm ở /api/* trên cùng địa chỉ đó, nên giao diện và API luôn thuộc cùng một bản.
k7xq2mfp9dhw.manh.run/ → giao diện (trang /, /requests, …)
k7xq2mfp9dhw.manh.run/api/requests → API của appTrước lần deploy đầu tiên, chỉ bạn xem được bản nháp trong bảng điều khiển. Người khác mở địa chỉ này sẽ thấy trang “chưa xuất bản”, còn API trả lỗi 503. Muốn người dùng thấy tên miền của công ty, xem Tên miền riêng.
Mỗi app đã deploy còn có sẵn: favicon.svg theo màu thương hiệu, sitemap.xml và robots.txt liệt kê các trang công khai có meta, trang 404 thật cho đường dẫn không có trang nào.
Database khi deploy
Mỗi app có một database SQLite riêng. Deploy chỉ thêm, không bớt:
- Bảng mới và cột mới trong
*.table.tsđược thêm vào. - Bảng hay cột bị xoá khỏi code vẫn nằm trong database; cột không bị đổi kiểu.
- Cột mới
NOT NULLkhông có giá trị mặc định được thêm ở dạng cho phép rỗng, và ghi chú của lần deploy nói rõ điều này. - Đổi tên cột: thêm cột mới, chép dữ liệu sang bằng
db_exec, rồi thôi dùng cột cũ. - Lần deploy đầu tiên nạp
spec/sample-data.json(nếu có) vào các bảng còn trống. Mục Cơ sở dữ liệu có nút xoá các dòng mẫu chưa ai sửa.
Secret và cấu hình
Secret (khoá API của dịch vụ ngoài, token) đặt ở mục Secret trên thanh bên của project, hoặc qua công cụ env_set. Backend đọc chúng bằng env.TÊN từ manh/env. Secret mới có hiệu lực ngay: app đang chạy khởi động lại với giá trị mới, không cần deploy.
manh.run tự đặt MANH_APP_URL và JWT_SECRET của app (tạo ở lần deploy đầu). Deploy và quay lại bản cũ luôn lấy secret và tên miền từ cài đặt hiện tại, không lấy từ bản cũ.
Nhãn “Made with manh.run”
App thuộc gói Free có một nhãn nhỏ “Made with manh.run” ở góc dưới bên trái, bấm vào sẽ dẫn về manh.run. Gói Builder và Agency không có nhãn này.
Cần biết
- manh.run không sao lưu database. Quay lại bản cũ chỉ đổi code, không đổi dữ liệu, nên hãy xuất bảng quan trọng ra CSV trước khi sửa lớn.
- Deploy không xoá cột hay bảng. Dọn dữ liệu cũ là việc bạn tự làm, sau khi đã đọc kỹ các dòng sẽ bị ảnh hưởng.
- Khi gói trả phí hết hạn và qua 7 ngày gia hạn, tài khoản trở về gói Free. App vẫn chạy, nhưng tên miền riêng tạm tắt và app hiện nhãn manh.run.
Bước tiếp theo
- Tên miền riêng — cho app chạy ở tên miền của công ty, như
app.congty.vn. - Nhật ký và lưu lượng — xem bản vừa deploy chạy ra sao và có lỗi gì.
- Rollback và checkpoint — quay app về bản trước khi bản mới có vấn đề.