Checkpoint
Hai công cụ checkpoint và restore_checkpoint để agent lưu cây file của project với một nhãn và đưa cây file về một bản đã lưu; khôi phục không làm đổi app đang chạy.
Checkpoint chỉ lưu code trong app/. Dữ liệu trong database không nằm trong checkpoint.
checkpoint
Lưu toàn bộ file hiện tại thành một checkpoint có nhãn. Checkpoint hiện trong tab Deploy & lịch sử của dashboard.
- Tham số:
project;label: nhãn 1–120 ký tự, ví dụ “Xong giai đoạn API”. - Trả về:
id,label,createdAt. - Khi nào gọi: sau mỗi giai đoạn chạy được, và trước một thay đổi lớn.
Checkpoint có nhãn không bao giờ bị xoá để lấy chỗ. Mỗi project giữ tối đa 100; quá số đó thì lần lưu mới bị từ chối với CHECKPOINT_LIMIT. Bản sao tự động (trước mỗi lần ghi đổi file, trước block_add) xoay vòng riêng, giữ 10 bản mới nhất.
restore_checkpoint
Thay toàn bộ file bằng một checkpoint hoặc bản sao tự động. Trước khi thay, manh.run lưu cây hiện tại thành một bản sao tự động để có thể quay lại.
- Tham số:
project;checkpoint_id: id lấy từget_project(mụccheckpoints) hoặc từ kết quả củawrite_files. - Trả về:
restored(số file),deployed: false. - Khi nào gọi: khi một thay đổi làm hỏng app và cần quay về bản trước.
App đang chạy không đổi cho tới khi gọi deploy. Cây file từng deploy thành công thì deploy bỏ qua bước check, nên quay về bản cũ không bị luật mới chặn.
restore_checkpoint({ project, checkpoint_id }) → cây file về bản cũ
deploy({ project }) → app chạy thật về bản cũBước tiếp theo
- Rollback và checkpoint: quay lại bản trước từ dashboard.
- deploy: đưa cây file đã khôi phục lên.
- File: bản sao tự động trước mỗi lần ghi.