Appearance
Object storage sau MinIO Community
Version: 0.1
Date: 2026-11-16
Status: PROPOSED (chờ Owner chốt hướng)
1. Bối cảnh
MinIO Community Edition không còn là lựa chọn an toàn cho triển khai mới:
- Community chuyển source-only / maintenance rồi archived (repo read-only; không còn binary/image community đáng tin; không security fix upstream).
- AIStor Free / Enterprise của MinIO không phải open-source phân phối tự do — lệch nguyên tắc ưu tiên OSS/self-hosted của MINAP nếu dùng làm SoT mặc định.
SoT File Service hiện tại (05, D-005) đã đúng hướng: Applications → File Service; bytes trên object storage S3-compatible; đổi provider không sửa Application.
2. Hai lớp — đừng nhầm
| Lớp | Vai trò | Tự build? |
|---|---|---|
| MINAP File Service | Metadata DB, authz, presign, lifecycle, variant cache | Có — đây là sản phẩm platform (đã DECIDED) |
| Object store (bytes) | Put/get object, multipart, signed URL | Không reinvent S3 server; chọn OSS hoặc cloud S3/R2 |
“Tự custom File Service hỗ trợ AWS/R2” = làm adapter S3 trong File Service (đã có trong D-005), không tự viết hệ thống lưu object erasure-coded thay MinIO.
3. Phương án đề xuất
A. Khuyến nghị kiến trúc (giữ nguyên ranh giới)
- File Service nói chuyện chỉ qua S3 API (AWS SDK / client tương thích).
- Cấu hình
provider+ credentials qua Infisical:garage|seaweedfs|s3|r2| … - Integration test: multipart, presign upload/download, delete, copy — trên từng provider được hỗ trợ.
- Non-prod có thể self-host OSS; staging/prod có thể R2 hoặc AWS S3 ngay khi Owner muốn giảm ops.
B. Ứng viên object store self-hosted (OSS)
| Ứng viên | License | Điểm mạnh | Điểm yếu / rủi ro | Phù hợp MINAP khi |
|---|---|---|---|---|
| Garage | AGPLv3 | Nhẹ, geo-friendly, ops đơn giản | Thiếu nhiều API S3 (versioning, Object Lock, …) | MVP / non-prod / cụm nhỏ; File Service chỉ cần put/get/presign cơ bản |
| SeaweedFS | Apache-2.0 | License thoải; feature S3 rộng hơn; scale | Nhiều component hơn; học ops | Cần OSS Apache + feature gần production self-host |
| RustFS | Apache-2.0 | Gần “MinIO-like”, S3 rộng, 1.0 GA (2026-09) | Lịch sử vận hành prod cộng đồng còn ngắn; claim hiệu năng cần tự benchmark | Ứng viên mạnh nếu muốn self-host Apache + DX giống MinIO — xem §3.1 |
| SILO (fork MinIO) | AGPLv3 | Ít migration format nếu đã có data MinIO | Vẫn một vendor fork; governance cần theo dõi | Chỉ nếu đã commit data MinIO và cần vá bảo mật nhanh |
| Ceph RGW | LGPL | Enterprise scale | Ops nặng — overkill MVP | Sau này nếu cluster lớn |
| AIStor Free | Proprietary-ish free | Gần MinIO commercial | Không OSS redistribute | Không khuyến nghị làm mặc định MINAP |
3.1 RustFS — đánh giá riêng
| Tiêu chí | Đánh giá cho MINAP |
|---|---|
| License | Apache-2.0 — khớp hướng OSS permissive hơn AGPL (Garage/MinIO) |
| Vai trò | Object store S3-compatible self-host; không thay File Service |
| API | Hướng tương thích S3 rộng (multipart, versioning, Object Lock, IAM/policy, … — theo matrix dự án); File Service vẫn chỉ dùng subset đã test |
| Maturity | 1.0 GA (2026-09); dự án còn trẻ so với MinIO/Ceph — rủi ro chính là ops history (heal, distributed, CVE response dài hạn), không phải “thiếu binary” |
| DX | Gần thay MinIO hơn Garage; có guide migrate MinIO→RustFS; on-disk tương thích MinIO chỉ preview, không mặc định tin |
| So với Garage | Nhiều feature S3 hơn; nặng/ops hơn cụm “nhẹ geo” của Garage |
| So với SeaweedFS | Cùng Apache-2.0; RustFS marketing gần MinIO drop-in; SeaweedFS ecosystem/ops pattern khác (volume/filer) — chọn theo team quen |
| Prod MINAP | Được coi là ứng viên self-host nếu Owner chấp nhận pilot + pin version + benchmark warp/s3bench trên hardware thật trước Gate 5 |
Kết luận ngắn: RustFS hợp lý làm self-host mặc định thay MinIO nếu ưu tiên Apache-2.0 + DX kiểu MinIO; vẫn bắt buộc qua adapter File Service; prod cloud (R2/S3) vẫn là đường an toàn ops nhất.
C. Cloud (đã nằm trong SoT)
| Provider | Khi nào |
|---|---|
| Cloudflare R2 | Muốn S3 API, chi phí egress thấp, ít ops server |
| AWS S3 | Chuẩn enterprise / compliance / ecosystem |
Cùng một adapter File Service — đổi endpoint + credential.
4. Khuyến nghị cụ thể (PROPOSED)
| Quyết định đề xuất | Nội dung |
|---|---|
| O1 | Ngừng coi MinIO Community là mặc định triển khai mới / tài liệu “MinIO trước” |
| O2 | Giữ File Service + S3-compatible adapter; không tự build object store |
| O2b — Multi-connection trong DB | Owner direction: bảng storage_connections lưu endpoint/bucket/credential (secret mã hóa); files.storage_connection_id trỏ connection đã dùng. Infisical chỉ giữ KEK, không phải từng key cloud. OSS lẫn S3/R2 cùng mô hình — xem 02 |
| O3 — Non-prod / self-host mặc định | Chốt một kind đăng ký như connection: Garage | SeaweedFS | RustFS (phải S3 API + access key) |
| O4 — Prod / scale / bỏ OSS giữa | B1 (Owner lean): thêm connection r2/s3 trên DB → migrate → disable connection OSS. B2 DEFERRED |
| O5 | Tài liệu và compose local đổi tên store-object → “S3-compatible object store (Garage/… )”; migration path nếu còn volume MinIO cũ |
Không khuyến nghị: bỏ File Service để Application ghi thẳng S3/R2 (phá D-005).
5. File Service lưu gì nếu chọn RustFS? Đổi store sau có được không?
Chi tiết cột: /architecture/database/02-file-service §3.1–3.2.
| Lớp | Lưu gì |
|---|---|
| File Service DB | file_id, display name, authz fields, lifecycle, storage_provider / storage_bucket / storage_key, size/MIME, purpose, quota… |
| RustFS | Chỉ bytes tại bucket+key |
| Infisical | Endpoint + access key object store |
| Application | Chỉ file_id |
Đổi RustFS → R2/S3/Garage/… sau này: khả thi nếu File Service chỉ dùng S3 API + metadata SoT ở Postgres + key opaque. Việc migrate = copy object + đổi config/provider — không đổi file_id phía Application.
Flow FS hiện tại (Owner): temp → promote local → job migrate R2/S3 (storage_connections); variant cache local (FS_VARIANT_ROOT). Xem 02. OSS giữa không bắt buộc cho hot path; cloud dùng khi hết retention local.
- Metadata schema
file_servicekhông phụ thuộc vendor. - 90. Store ngoài: object store S3-compatible (hoặc không dùng nếu B2).
6. Bước tiếp (Owner)
- Chốt O3: Garage vs SeaweedFS vs RustFS (self-host MVP).
- Chốt O4: non-prod self-host + prod cloud ngay, hay self-host cả hai giai đoạn đầu.
- Nếu chọn RustFS: pin image/tag đã verify; chạy checklist S3 (presign, multipart, delete) trên File Service trước khi coi DECIDED.
- Sau khi chốt → cập nhật D-005,
05-storage, compose/infra, glossary.
7. Tham chiếu
- File Service: /architecture/05-storage-and-file-service
- Store ngoài: /architecture/database/90-external-stores
- D-005 (sẽ sửa sau khi Owner approve O1–O4)