Lewati ke konten utama

Object Storage (MinIO)

Frog Cloud menyediakan layanan Object Storage yang sepenuhnya kompatibel dengan protokol Amazon S3 (di balik layar, sistem ini ditenagai oleh klaster MinIO).

Melalui modul Backoffice ini, Admin tingkat atas dapat memantau seluruh simpul (node) MinIO yang tersebar di berbagai lokasi, melihat metrik ukuran secara langsung (live size), dan menguji konektivitas Gateway ke mesin penyimpanan tersebut.

1. Melihat Daftar Node MinIO​

Setiap Location (Lokasi Data Center, misalnya Jakarta atau Singapura) umumnya memiliki satu atau lebih Gateway MinIO. Admin dapat melihat daftar node penyimpanan ini beserta kapasitas yang dikonfigurasikan.

Request
GET /api/backoffice/storage/objects

Respons (200 OK): Backend akan mengembalikan array data Object Storage. Di dalam respons tersebut, terdapat satu field unik bernilai live_size.

Catatan Penting (Live Size): Nilai live_size didapatkan dari proses agregasi metrics MinIO. Jika data ini terlalu berat untuk ditarik secara langsung (real-time) setiap saat, Backend biasanya akan melakukan caching di dalam Redis. Frontend cukup merender data ini sebagai "Kapasitas Terpakai" di UI Dashboard.

2. Pengujian Konektivitas (Ping MinIO)​

Mengingat MinIO berjalan pada jaringan internal (VPC) atau publik yang memiliki lapisan sekuriti ketat, terkadang Admin perlu memastikan apakah Backend API Frog Cloud masih bisa berkomunikasi dengan server MinIO yang bersangkutan.

Admin dapat melakukan Health Check secara manual dengan menekan tombol "Test Connection" pada UI.

Request
POST /api/backoffice/storage/minio/{location_id}/ping
Content-Type: application/json

(Ganti {location_id} dengan ID Lokasi Data Center tempat MinIO tersebut bersarang).

Kondisi & Tindakan:

  • Sukses (200 OK): Backend berhasil mengeksekusi proses login (otentikasi) menggunakan kredensial (MINIO_ACCESS_KEY_ID & MINIO_SECRET_ACCESS_KEY) ke server MinIO spesifik tersebut. Tampilkan notifikasi hijau (berhasil).
  • Error (500/400): Tampilkan pesan error teknis dari response kepada Admin, karena ini menandakan adanya masalah infrastruktur (misal: S3 mati, firewall terblokir, atau kredensial kedaluwarsa).

Diagram Arsitektur Interaksi S3​