Konfigurasi dan Penggunaan Perkhidmatan Storan Objek MinIO di ServBay

MinIO ialah pelayan storan objek sumber terbuka yang berprestasi tinggi dan sepenuhnya serasi dengan API Amazon S3. Ia amat sesuai untuk mensimulasikan perkhidmatan storan awan dalam persekitaran pembangunan setempat, untuk menyimpan dan mengurus data tak berstruktur seperti gambar, video, fail log, sandaran dan imej kontena. Melalui ServBay, anda boleh memasang dan menguruskan instans MinIO setempat di macOS anda dengan amat mudah.

Pengenalan

ServBay menawarkan pemasangan MinIO secara satu klik dan antara muka konfigurasi berasaskan grafik, sekaligus memudahkan penyediaan storan serasi S3 di persekitaran setempat. Pembangun tidak perlu lagi berdepan pemasangan baris perintah yang rumit—hanya beberapa langkah mudah untuk mendapatkan perkhidmatan storan objek yang lengkap untuk pembangunan dan ujian aplikasi.

Lebih penting lagi, ServBay akan secara automatik menyediakan konsol web yang selamat dan mudah diakses untuk instans MinIO anda, menggunakan domain https://minio.servbay.host/.

Prasyarat

• macOS anda telah berjaya memasang dan menjalankan ServBay.
• Memiliki pengetahuan asas mengenai konsep storan objek seperti Bucket dan Object.

Langkah-langkah

1. Pasang Pakej MinIO

Mula-mula, anda perlu memasang MinIO dalam ServBay:

1. Buka aplikasi ServBay.
2. Pada bar navigasi sebelah kiri, klik Pakej (Packages).
3. Cari senarai pakej dan temui Storan Objek - MinIO.
4. Klik butang pemasangan di sebelah kanan MinIO dan tunggu sehingga pemasangan selesai.
5. Klik butang aktifkan untuk menghidupkan perkhidmatan MinIO.

2. Konfigurasikan Perkhidmatan MinIO

Setelah pemasangan selesai, lakukan konfigurasi awal MinIO:

1. Dalam bar navigasi kiri ServBay, klik Object Storage.

2. Dari menu turun, pilih MinIO untuk masuk ke halaman konfigurasi.

   

3. Anda akan lihat beberapa tetapan yang boleh diubahsuai atau dibiarkan sebagai lalai:

   • Bind IP (Alamat IP): Alamat IP yang didengar oleh perkhidmatan MinIO. Nilai lalai 127.0.0.1 bermakna perkhidmatan hanya boleh diakses dari mesin sendiri — ini adalah pilihan paling selamat dan disarankan untuk pembangunan setempat.
   • API Port (Port API): Port komunikasi untuk API S3. Aplikasi anda akan berhubung dengan MinIO melalui port ini. Lalai ialah 9000.
   • Root user (Pengguna akar): Nama pengguna akaun pentadbir MinIO. Lalai ialah minio.
   • Root password (Kata laluan akar): Kata laluan akaun pentadbir. Sangat disarankan anda menetapkan kata laluan yang kompleks dan unik serta pastikan ia disimpan dengan selamat. Ini adalah kunci untuk akses dan pengurusan semua data anda.
   • Data Path (Laluan Data): Laluan sistem fail setempat untuk menyimpan semua objek dan metadata MinIO. Lalai ialah /Applications/ServBay/data/minio. Anda boleh klik ikon folder di sebelah kanan untuk membuka direktori ini dengan pantas di Finder.

3. Simpan Konfigurasi dan Mulakan Perkhidmatan

1. Setelah selesai semua konfigurasi, klik butang Simpan (Save) di kanan bawah.
2. Jika semuanya berjalan lancar, penunjuk status perkhidmatan akan bertukar menjadi hijau—menandakan MinIO berjalan dengan berjaya.

4. Akses Konsol Web MinIO

Salah satu kelebihan ServBay ialah ia telah siap menyediakan antara muka pengurusan web MinIO untuk anda:

1. Cara akses pertama: Di sudut kanan atas halaman konfigurasi MinIO, klik ikon pelayar (bentuk kompas); ServBay akan membuka konsol MinIO secara automatik dalam pelayar lalai anda.

2. Cara akses kedua: Taip secara manual https://minio.servbay.host/ dalam pelayar anda.

   

3. Log masuk menggunakan Root user dan Root password yang anda tetapkan pada Langkah 2.

Selepas log masuk, anda boleh menggunakan antara muka web intuitif ini untuk mencipta bucket, memuat naik dan menguruskan fail (Object), serta menetapkan polisi akses dan banyak lagi.

5. Menggunakan MinIO dalam Aplikasi Anda

Aplikasi anda (PHP, Node.js, Python dan lain-lain) boleh berhubung ke instans MinIO dalam ServBay menggunakan mana-mana SDK yang serasi S3. Maklumat penting berikut diperlukan untuk sambungan:

• Endpoint (Titik akhir): http://127.0.0.1:9000
• Access Key ID (ID Kunci Akses): Root user yang anda tetapkan (cth. minio)
• Secret Access Key (Kunci Akses Rahsia): Root password yang anda tetapkan
• Use path style endpoint (Guna endpoint gaya-laluan): Amat disarankan tetapkan kepada true.

Contoh Kod PHP (Menggunakan AWS SDK for PHP)

Pasang SDK terlebih dahulu:

composer require aws/aws-sdk-php

Kemudian, konfigurasikan dan guna klien S3 dalam kod anda:

<?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 boleh jadi sebarang string yang sah
    '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) {
    // Paparkan maklumat ralat
    echo "Error: " . $e->getMessage() . "\n";
}

Soalan Lazim (FAQ)

• S: Saya terlupa Root password MinIO, bagaimana untuk set semula?
  • J: Menetapkan semula kata laluan dalam ServBay amat mudah. Hanya masukkan kata laluan baharu di halaman konfigurasi MinIO, klik Simpan (Save), kemudian mulakan semula perkhidmatan MinIO. ServBay akan mengemaskini fail konfigurasi anda secara automatik.
• S: MinIO gagal dimulakan, apa yang perlu saya lakukan?
  • J: Sila semak perkara berikut:
    1. Klik ikon log di sudut kanan atas halaman konfigurasi MinIO untuk melihat butiran ralat.
    2. Pastikan port 9000 tidak digunakan oleh aplikasi lain.
    3. Semak sama ada Data Path anda wujud serta ServBay mempunyai kebenaran baca/tulis ke direktori itu.
• S: Bolehkah saya menukar API Port MinIO?
  • J: Boleh. Hanya ubah medan API Port dalam halaman konfigurasi MinIO di ServBay, simpan dan mulakan semula perkhidmatan. Pastikan aplikasi anda juga dikemaskini dengan port baharu.

Kesimpulan

Dengan bantuan ServBay, urusan konfigurasi dan menjalankan instans MinIO setempat di macOS menjadi sangat mudah. Solusi ini amat sesuai untuk pembangunan dan ujian aplikasi yang memerlukan penyimpanan serasi S3, membolehkan pembangun memberi tumpuan kepada logik perniagaan tanpa perlu membuang masa untuk persediaan persekitaran.