Cài đặt và sử dụng — Backup & Restore

Tổng quan

Plugin hỗ trợ sao lưu (backup) và phục hồi (restore) toàn bộ hệ thống Digiforce. Backup bao gồm database (collections, cấu hình, users) và có thể bao gồm cả file uploads. File backup được lưu trực tiếp trên filesystem — không lưu trong database.

Yêu cầu hệ thống

Server Digiforce đang chạy
Quyền Admin để truy cập chức năng Backup & Restore
Đủ dung lượng disk cho file backup (tối thiểu 2x kích thước database)

Bước 1: Kích hoạt plugin

Vào Settings → Plugin Manager, tìm plugin-backup-restore và bật. Khởi động lại server.

Bước 2: Tạo Backup

Vào Settings → Backup & Restore
Nhấn Create Backup
Chọn nội dung backup:

Tuỳ chọn	Bao gồm	Kích thước
Full backup	Database + file uploads + attachments	Lớn
Database only	Chỉ database (collections, cấu hình, users)	Nhỏ hơn

Chọn collections muốn backup (hoặc chọn tất cả)
Đợi quá trình dump hoàn tất

Luồng tạo backup

Bước 3: Quản lý Backups

Trang Backup & Restore hiển thị danh sách tất cả backup:

Cột	Mô tả
Tên file	Tên file backup (tự động sinh theo timestamp)
Ngày tạo	Thời gian tạo backup
Kích thước	Dung lượng file backup
Loại	Full hoặc Database only

Các thao tác

Thao tác	Mô tả	Ghi chú
Download	Tải file backup về máy	Để lưu trữ bên ngoài server
Restore	Khôi phục từ backup này	⚠️ Ghi đè toàn bộ dữ liệu hiện tại
Delete	Xoá file backup	Giải phóng dung lượng disk
Upload	Upload file backup từ máy tính	Cho restore từ server khác

Bước 4: Restore (Phục hồi)

Cảnh báo quan trọng

Restore ghi đè toàn bộ dữ liệu hiện tại. Đảm bảo:

Đã tạo backup mới nhất trước khi restore
Tất cả user đã logout
Không có thao tác đang diễn ra trên hệ thống

Quy trình restore

Chọn backup từ danh sách (hoặc upload file backup)
Nhấn Restore
Xác nhận hành động (không thể hoàn tác)
Restorer đọc file backup → ghi ngược vào database
Server tự động khởi động lại sau khi restore hoàn tất

Restore từ command line

Ngoài giao diện, có thể restore qua CLI:

bash

# Restore từ file backup trên server
digiforce restore --file storage/backups/backup-2024-03-15.nbdump

Migration giữa các môi trường

Plugin hỗ trợ chuyển dữ liệu giữa các môi trường (dev → staging → production):

Tạo backup trên môi trường nguồn (ví dụ: dev)
Download file backup
Upload file backup lên môi trường đích (ví dụ: staging)
Restore — dữ liệu và cấu hình được chuyển sang

WARNING

Đảm bảo phiên bản Digiforce trên môi trường đích tương thích với backup. Backup từ phiên bản mới có thể không restore được trên phiên bản cũ.

Các collection có thể backup

Gọi API để xem danh sách:

typescript

const response = await agent.resource('backupFiles').dumpableCollections();
// Trả về danh sách collections có thể đưa vào backup

Lưu trữ file backup

File backup được lưu trong thư mục storage/backups/ trên server:

Đặc điểm	Chi tiết
Vị trí	`./storage/backups/`
Định dạng	`.nbdump` (archive format nội bộ)
Đặt tên	`backup-{timestamp}.nbdump`
Metadata	Đọc từ filesystem (tên, kích thước, ngày tạo)

Lưu ý quan trọng

Restore ghi đè toàn bộ dữ liệu — luôn tạo backup mới nhất trước khi restore
Test restore định kỳ để đảm bảo backup hoạt động (trên môi trường test)
Lưu file backup ở nơi an toàn ngoài server (S3, NAS, external drive)
Backup lớn mất thời gian — chạy vào giờ thấp điểm
File backup chứa dữ liệu nhạy cảm — bảo vệ bằng mã hoá hoặc kiểm soát truy cập
Plugin không tạo bảng riêng trong database — metadata đọc trực tiếp từ filesystem