Mengonfigurasi dan Menggunakan Layanan Penyimpanan Objek MinIO di ServBay

MinIO adalah server penyimpanan objek sumber terbuka berperforma tinggi yang sepenuhnya kompatibel dengan Amazon S3 API. MinIO sangat ideal untuk mensimulasikan layanan cloud storage di lingkungan pengembangan lokal, memungkinkan Anda menyimpan serta mengelola data tidak terstruktur seperti gambar, video, file log, backup, dan image container. Melalui ServBay, Anda dapat dengan mudah menerapkan serta mengelola instansi MinIO lokal di macOS.

Gambaran Umum

ServBay menyediakan proses instalasi MinIO satu-klik dan antarmuka konfigurasi grafis yang sangat memudahkan dalam membangun storage kompatibel S3 di lingkungan lokal. Developer tidak perlu repot mengelola instalasi serta konfigurasi melalui command line dan dapat langsung menggunakan layanan penyimpanan objek yang lengkap untuk pengembangan dan pengujian aplikasi.

Yang lebih penting lagi, ServBay secara otomatis mengonfigurasi konsol web MinIO yang aman dan mudah diakses dengan domain https://minio.servbay.host/.

Prasyarat

• Sistem macOS Anda telah menginstal dan menjalankan ServBay dengan baik.
• Anda memiliki pemahaman dasar tentang konsep penyimpanan objek seperti Bucket (Ember) dan Object (Objek).

Langkah-Langkah Pengoperasian

1. Instal Paket MinIO

Langkah pertama, Anda perlu menginstal MinIO di ServBay:

1. Buka aplikasi ServBay.
2. Pada panel navigasi kiri, klik Software Packages (Paket Perangkat Lunak).
3. Pada daftar paket, temukan bagian Object Storage - MinIO.
4. Klik tombol instal di sebelah kanan MinIO, lalu tunggu proses instalasi selesai.
5. Klik tombol aktifkan untuk menyalakan layanan MinIO.

2. Konfigurasi Layanan MinIO

Setelah proses instalasi selesai, lanjutkan dengan konfigurasi awal MinIO:

1. Pada panel navigasi kiri di ServBay, klik Object Storage.

2. Pilih MinIO dari menu dropdown untuk masuk ke halaman konfigurasi.

   

3. Anda akan melihat pilihan konfigurasi berikut yang bisa disesuaikan sesuai kebutuhan atau tetap menggunakan nilai default:

   • Bind IP (IP Terikat): Alamat IP yang digunakan MinIO untuk mendengarkan koneksi. Nilai default 127.0.0.1 membuat layanan hanya bisa diakses dari komputer lokal — pengaturan ini paling aman dan direkomendasikan untuk development lokal.
   • API Port (Port API): Port yang digunakan untuk komunikasi S3 API. Aplikasi Anda akan berinteraksi dengan MinIO melalui port ini. Default: 9000.
   • Root user (Pengguna Root): Nama akun administrator MinIO. Default: minio.
   • Root password (Password Root): Kata sandi akun administrator. Sangat disarankan untuk menggunakan kata sandi yang kuat dan unik, serta menyimpannya dengan aman karena ini kunci utama untuk mengakses dan mengelola semua data Anda.
   • Data Path (Path Data): Direktori di sistem file lokal di mana MinIO menyimpan semua objek dan metadata. Default: /Applications/ServBay/data/minio. Anda dapat mengklik ikon folder di sebelah kanan untuk langsung membuka direktori ini di Finder.

3. Simpan Konfigurasi dan Mulai Layanan

1. Setelah semua konfigurasi selesai, klik tombol Save (Simpan) di kanan bawah.
2. Jika semuanya berjalan lancar, indikator status layanan akan berubah menjadi hijau, menandakan MinIO telah berjalan sukses.

4. Akses Konsol Web MinIO

Salah satu keunggulan ServBay adalah konsol web MinIO yang langsung siap digunakan:

1. Cara pertama: Di pojok kanan atas halaman konfigurasi MinIO, klik ikon browser (ikon kompas). ServBay akan otomatis membuka konsol MinIO di browser default Anda.

2. Cara kedua: Buka browser dan masukkan alamat https://minio.servbay.host/.

   

3. Login dengan Root user dan Root password yang telah Anda atur di langkah 2.

Setelah login, Anda dapat membuat bucket (ember), mengunggah dan mengelola file (objek), mengatur kebijakan akses, dan banyak lagi melalui antarmuka web yang intuitif.

5. Menggunakan MinIO di Aplikasi Anda

Aplikasi Anda (misal PHP, Node.js, Python, dll) dapat terhubung ke MinIO di ServBay menggunakan SDK yang kompatibel dengan S3. Berikut data penting yang Anda perlukan saat menghubungkan aplikasi:

• Endpoint: http://127.0.0.1:9000
• Access Key ID: Root user yang sudah dikonfigurasi (misal minio)
• Secret Access Key: Root password yang sudah dikonfigurasi
• Use path style endpoint (Gunakan endpoint model path): Sangat disarankan diatur ke true.

Contoh Kode PHP (Dengan AWS SDK for PHP)

Pertama, instal SDK:

composer require aws/aws-sdk-php

Kemudian di kode Anda, konfigurasikan dan gunakan klien S3:

<?php
require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

$s3Client = new S3Client([
    'profile' => 'default',
    'version'     => 'latest',
    'region'      => 'us-east-1', // Untuk MinIO, region bisa berupa string apapun yang valid
    'endpoint'    => 'http://127.0.0.1:9000',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => 'minio', // Root user Anda
        'secret' => 'your-strong-password', // Root password Anda
    ],
]);

try {
    $buckets = $s3Client->listBuckets();
    foreach ($buckets['Buckets'] as $bucket) {
        echo $bucket['Name'] . "\n";
    }
} catch (AwsException $e) {
    // Tampilkan pesan error
    echo "Error: " . $e->getMessage() . "\n";
}

Pertanyaan yang Sering Diajukan (FAQ)

• Q: Saya lupa Root password MinIO, bagaimana cara reset?
  • A: Sangat mudah untuk mereset password di ServBay. Cukup masukkan password baru di halaman konfigurasi MinIO, klik Save (Simpan), lalu restart layanan MinIO. ServBay akan otomatis memperbarui file konfigurasi untuk Anda.
• Q: MinIO gagal dijalankan, apa yang harus saya lakukan?
  • A: Silakan periksa beberapa hal berikut:
    1. Klik ikon log di kanan atas halaman konfigurasi MinIO untuk melihat pesan error secara detail.
    2. Pastikan port 9000 tidak sedang digunakan oleh aplikasi lain.
    3. Cek apakah Data Path yang Anda tentukan sudah ada dan apakah ServBay punya izin baca/tulis di direktori tersebut.
• Q: Apakah saya bisa mengganti port API MinIO?
  • A: Bisa. Cukup ubah field API Port di halaman konfigurasi MinIO pada ServBay, simpan dan restart layanan. Pastikan aplikasi Anda juga mengakses port baru tersebut.

Ringkasan

Dengan bantuan ServBay, mengonfigurasi dan menjalankan instansi MinIO lokal di macOS menjadi sangat mudah. Ini memberikan kemudahan besar untuk pengembangan dan pengujian aplikasi lokal yang membutuhkan storage kompatibel S3, sehingga Anda bisa fokus pada logika bisnis tanpa ribet urusan setting lingkungan atau infrastruktur penyimpanan.