Lewati ke konten utama

VM Tier Management

Sebelum Customer dapat membuat sebuah Virtual Machine (VM), Admin harus mendefinisikan "menu" spesifikasi mesin yang bisa mereka beli. Dalam arsitektur Frog Cloud, spesifikasi ini dibagi menjadi dua konsep: Tier Type (Keluarga Mesin) dan Tier (Spesifikasi Detail).

Dokumentasi ini ditujukan bagi Frontend Engineer untuk menyusun Dashboard Backoffice pada menu Infrastructure > VM Tiers.

Diagram Relasi Spesifikasi Mesin​

1. Tier Types (Keluarga Mesin)​

Tier Type digunakan untuk mengelompokkan jenis workload. Contoh umum: General Purpose, CPU Optimized, atau Memory Optimized.

Request (Daftar Tier Types)
GET /api/backoffice/node/tier-types
Request (Buat Kategori Baru)
POST /api/backoffice/node/tier-type
Request (Ubah Kategori)
POST /api/backoffice/node/tier-type/{id}/update

Tindakan Frontend: Saat menampilkan form pembuatan Tier, Frontend wajib mengambil data dari GET /api/backoffice/node/tier-types untuk dijadikan pilihan dropdown (misalnya: "Pilih Keluarga Mesin").

2. Tiers (Paket Spesifikasi VM)​

Tier adalah paket akhir yang akan dilihat oleh pelanggan (misal: "Basic 2GB RAM / 1 vCPU" atau "Pro 16GB RAM / 8 vCPU").

Request (Daftar Seluruh Tier)
GET /api/backoffice/tier/tiers
Request (Buat Spesifikasi Baru)
POST /api/backoffice/tier/create

Konfigurasi Tingkat Lanjut (Advanced Config)​

Selain menentukan RAM dan CPU, setiap paket memiliki parameter hardware tingkat lanjut yang bisa diubah (di-Tuning) oleh Admin secara real-time tanpa harus menghapus paket tersebut:

  • Batas Kecepatan CPU (CPU Limit):
    PATCH /api/backoffice/tier/{id}/update-cpu
    (Berguna untuk mencegah monopoli resource oleh pelanggan pada mesin Shared CPU).

  • Status Visibilitas (Toggle Status):
    PATCH /api/backoffice/tier/{id}/toggle-status
    (Jika berstatus false, pelanggan baru tidak bisa melihat paket ini, tetapi pelanggan lama tetap bisa memperpanjang siklusnya).

Konfigurasi Load Balancer (Networking Khusus)​

Jika paket ini dikhususkan untuk mesin beban berat, Admin dapat menyalakan kapabilitas Load Balancer bawaan:

  • Nyalakan/Matikan Fitur LB:
    PATCH /api/backoffice/tier/{id}/toggle-loadbalance

  • Ubah Konfigurasi LB:
    PATCH /api/backoffice/tier/{id}/update-loadbalance

Penghapusan (Retirement)​

Request
DELETE /api/backoffice/tier/{id}/delete

Catatan UX untuk Frontend: Saat Admin menekan tombol Hapus, selalu tampilkan peringatan Confirmation Modal berwarna merah (Danger), karena menghapus paket dapat berdampak pada penagihan pelanggan yang sedang berlangganan paket tersebut.