Skip to Content

deploy

Công cụ deploy chạy check, build giao diện và backend, cập nhật schema rồi đưa giao diện và API lên <id>.manh.run cùng lúc; đây là lệnh duy nhất làm đổi app đang chạy.

deploy

  • Tham số:
    • project.
    • force: deploy dù còn lỗi kiểu TypeScript hoặc lỗi hiển thị trang. Không bỏ qua được lỗi cú pháp, luật cấm hay hợp đồng.
    • reason (bắt buộc khi có force, 5–300 ký tự): vì sao lỗi kiểu đó không làm hỏng app. manh.run ghi lý do vào bản ghi deploy.
  • Trả về:
    • handover: app đã sẵn sàng giao chưa. Còn bài kiểm tra hỏng hoặc còn việc chưa xong thì là NOT READY kèm việc agent phải làm ngay, trước khi trả lời bạn.
    • tests: kết quả bài kiểm tra chạy trên bản thử (passed, total, các bài hỏng).
    • kết quả deploy (ghi chú về schema, cron đã đăng ký, check có được bỏ qua không), các địa chỉ của app, mục Progress và bước next.
  • Khi nào gọi: khi giai đoạn API qua check, để chạy thử API thật; và khi app làm xong.

Ở địa chỉ /directory không có force và reason.

Deploy làm những gì

  1. Check. Chạy cả bốn lớp, gồm kiểm kiểu. Còn lỗi thì trả CHECK_FAILED kèm danh sách lỗi; app đang chạy giữ nguyên.
  2. Giao diện. Biên dịch mọi file .tsx thành file tĩnh. Mỗi route tĩnh có HTML riêng mang export const meta của trang đó. Lỗi biên dịch trả về file:dòng trước khi có gì thay đổi.
  3. Backend. Gói mọi file .ts backend thành một bản. Lỗi gói cũng trả file:dòng.
  4. Schema. Bảng trong *.table.ts được áp vào database riêng của app khi bản mới khởi động. Chỉ thêm bảng và cột, không xoá hay đổi kiểu cột.
  5. Chạy thật. Giao diện và API chuyển sang bản mới cùng lúc. deploy chờ tới khi bản mới trả lời, thường mất 3–10 giây, lần đầu lâu hơn.
  6. Kiểm thử. Chạy bài kiểm tra trong spec/acceptance.json (chưa có thì là bài kiểm tra nhanh manh.run tạo từ các file) trên một bản thử có database riêng, trong khoảng 30 giây. Dữ liệu thật không bị đụng tới. Xem Kiểm thử.

Cây file từng deploy thành công thì bỏ qua bước check (kết quả ghi gate: "known_good"). Nhờ vậy restore_checkpoint rồi deploy luôn quay lại được bản cũ, kể cả khi check đã có luật mới.

https://<id>.manh.run/ giao diện https://<id>.manh.run/api/* API (app/orders/get.ts = GET /api/orders)

Bước tiếp theo

Cập nhật