ADR-0004 — QNAP OSS untuk File Storage

Tanggal: 2026-xx-xx Status: Accepted

Konteks

geonet-console perlu storage untuk avatar user. Awalnya disimpan di filesystem lokal Docker container, tapi container rebuild akan menghapus semua file.

Keputusan

Menggunakan QNAP QuObjects (OSS) — S3-compatible object storage di 10.100.1.10:8010. Laravel menggunakan disk oss dengan driver s3 + use_path_style_endpoint=true.

Alasan

QNAP TS-932X sudah ada di infrastruktur (tidak perlu beli)
S3-compatible → bisa pakai Laravel s3 driver standar
File persists meski container rebuild atau crash
URL publik via Nginx proxy (file.gisportal.id/super-apps/) tanpa expose QNAP langsung

Alternatif Ditolak

Docker volume lokal: File hilang saat image recreate, tidak scalable
NFS mount: Lebih kompleks, risiko hanging mount
Cloud S3 (AWS, Cloudflare R2): Biaya, data harus internal
Minio: Perlu server/container tambahan, QNAP sudah ada

Konsekuensi

Bucket super-apps wajib di-set public-read (X-Container-Read: .r:*,.rlistings)
ACL bisa ter-reset → monitoring manual atau script cek berkala
Format access key: <storage-space>:<key-id> (format QNAP)
Driver s3 wajib pakai use_path_style_endpoint=true (QNAP tidak support virtual hosted-style)
OSS_SECRET_ACCESS_KEY hanya ada di .env server — tidak di repo

1.4 KiB Raw Blame History