ServBay’de MinIO Nesne Depolama Hizmeti Nasıl Kurulur ve Kullanılır

MinIO, yüksek performanslı ve Amazon S3 API ile uyumlu açık kaynaklı bir nesne depolama sunucusudur. Yerel geliştirme ortamlarında bulut depolama hizmetini simüle etmek, yapılandırılmamış verileri (resimler, videolar, log dosyaları, yedeklemeler ve konteyner imajları gibi) saklamak ve yönetmek için idealdir. ServBay sayesinde, macOS’ta yerel bir MinIO örneğini rahatlıkla kurup yönetebilirsiniz.

Genel Bakış

ServBay, MinIO’nun tek tıkla kurulmasını ve görsel olarak yapılandırılmasını sağlayan bir arayüz sunar. Böylece, yerel ortamda S3 uyumlu bir depolama altyapısı hazırlamak çok daha kolaylaşır. Geliştiriciler, karmaşık komut satırı adımlarıyla uğraşmadan, uygulama geliştirme ve test için tam donanımlı bir nesne depolama çözümüne hızla sahip olabilirler.

Dahası, ServBay MinIO örneğiniz için güvenli ve erişimi kolay bir web kontrol panelini, https://minio.servbay.host/ alan adıyla otomatik olarak yapılandırır.

Gereksinimler

• macOS sisteminizde ServBay yüklü ve çalışır durumda olmalıdır.
• Nesne depolama kavramları (ör. Bucket yani saklama kovası, Object yani nesne) hakkında temel bilgiye sahip olmalısınız.

Adım Adım Kurulum

1. MinIO Paketini Kurun

İlk olarak, ServBay üzerinden MinIO’yu kurmalısınız:

1. ServBay uygulamasını açın.
2. Sol menüden Yazılım Paketleri (Packages) bölümüne tıklayın.
3. Paket listesinde Nesne Depolama - MinIO seçeneğini bulun.
4. MinIO sağındaki yükle butonuna tıklayın ve kurulumun tamamlanmasını bekleyin.
5. MinIO servisini etkinleştirmek için etkinleştir (enable) butonuna tıklayın.

2. MinIO Servisini Yapılandırın

Kurulum tamamlandıktan sonra MinIO’nun temel ayarlarını yapılandırmanız gerekmektedir:

1. Sol menüden Object Storage seçeneğine tıklayın.

2. Açılan menüden MinIO’yu seçin ve yapılandırma bölümüne girin.

   

3. Aşağıdaki ayarları göreceksiniz; isterseniz değiştirebilir ya da varsayılanları kullanabilirsiniz:

   • Bind IP (Bağlanacak IP): MinIO’nun dinleyeceği IP adresi. Varsayılan değer 127.0.0.1’dir ve bu sayede servis sadece yerel makineye açıktır. Bu, yerel geliştirme için önerilen en güvenli ayardır.
   • API Port (API Portu): S3 API ile iletişim için kullanılan port. Uygulamalarınız MinIO ile bu port üzerinden haberleşir; varsayılan olarak 9000’dir.
   • Root user (Admin Kullanıcı Adı): MinIO yönetici hesabı. Varsayılan olarak minio’dur.
   • Root password (Admin Şifre): Yönetici hesabının şifresi. Kesinlikle karmaşık ve benzersiz bir parola belirleyin ve güvenli bir yerde saklayın. Tüm verilerinize erişim ve yönetim için bu anahtardır.
   • Data Path (Veri Dizini): MinIO’nun tüm nesneleri ve meta verileri saklayacağı dosya yolu. Varsayılan olarak /Applications/ServBay/data/minio’dur. Yanındaki klasör simgesine tıklayarak klasörü Finder’da hızlıca açabilirsiniz.

3. Ayarları Kaydedin ve Servisi Başlatın

1. Tüm ayarları tamamladıktan sonra sağ alttaki Kaydet (Save) butonuna tıklayın.
2. Her şey yolundaysa, servis durum göstergesi yeşil olur ve MinIO başarıyla çalışmaya başlar.

4. MinIO Web Konsoluna Erişim

ServBay’in en kullanışlı özelliklerinden biri, MinIO için web yönetim arayüzünü otomatik olarak sizin için hazırlamasıdır:

1. Birinci yol: MinIO yapılandırma ekranının sağ üstündeki tarayıcı simgesine (pusula şeklinde) tıklayın; ServBay MinIO konsolunu varsayılan tarayıcınızda açar.

2. İkinci yol: Tarayıcıya manuel olarak https://minio.servbay.host/ adresini yazın.

   

3. 2. adımda belirlediğiniz Root user ve Root password ile giriş yapın.

Giriş yaptıktan sonra bu kullanıcı dostu web paneliyle kolayca saklama kovası (Buckets) oluşturabilir, dosya (Object) yükleyip yönetebilir ve erişim politikalarını düzenleyebilirsiniz.

5. MinIO’yu Uygulamaya Bağlama

Uygulam (ör. PHP, Node.js, Python vb.), S3 uyumlu herhangi bir SDK ile ServBay’deki MinIO örneğine bağlanabilir. Bağlantı için şu bilgilere ihtiyacınız olacak:

• Endpoint (Uç Nokta): http://127.0.0.1:9000
• Access Key ID (Erişim Anahtarı Kimliği): Tanımladığınız Root user (ör. minio)
• Secret Access Key (Gizli Anahtar): Tanımladığınız Root password
• Use path style endpoint (Yol stili uç nokta kullan): Kesinlikle true olarak ayarlanması önerilir.

PHP Kod Örneği (AWS SDK for PHP ile)

İlk olarak SDK’yı kurun:

composer require aws/aws-sdk-php

Daha sonra kodunuzda S3 istemcisini şu şekilde yapılandırın:

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

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

$s3Client = new S3Client([
    'profile' => 'default',
    'version'     => 'latest',
    'region'      => 'us-east-1', // MinIO için, bölge herhangi bir geçerli dize olabilir
    'endpoint'    => 'http://127.0.0.1:9000',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => 'minio', // Sizin Root user’ınız
        'secret' => 'your-strong-password', // Sizin Root password’ünüz
    ],
]);

try {
    $buckets = $s3Client->listBuckets();
    foreach ($buckets['Buckets'] as $bucket) {
        echo $bucket['Name'] . "\n";
    }
} catch (AwsException $e) {
    // Hata bilgisini yazdır
    echo "Hata: " . $e->getMessage() . "\n";
}

Sık Sorulan Sorular (SSS)

• S: MinIO’nun Root password’ünü unuttum, nasıl sıfırlayabilirim?
  • C: ServBay’de yeni bir şifre belirlemek çok kolaydır. MinIO yapılandırma ekranında yeni bir şifre girip Kaydet (Save) tuşuna basın ve MinIO servisini yeniden başlatın. ServBay gerekli ayar dosyasını otomatik olarak güncelleyecektir.
• S: MinIO servisi başlatılamıyor, ne yapabilirim?
  • C: Şunları kontrol edin:
    1. MinIO yapılandırmasının sağ üstündeki log (kayıt) simgesine tıklayarak ayrıntılı hata mesajlarını inceleyin.
    2. 9000 portunun başka bir uygulama tarafından kullanılıp kullanılmadığını kontrol edin.
    3. Belirttiğiniz Data Path dizininin mevcut ve ServBay’in bu klasöre okuma/yazma iznine sahip olduğundan emin olun.
• S: MinIO’nun API portunu değiştirebilir miyim?
  • C: Evet. ServBay içindeki MinIO yapılandırmasında API Port alanını değiştirip kaydedin ve servisi yeniden başlatın. Ayrıca uygulamanızda da yeni portu kullandığınızdan emin olun.

Sonuç

ServBay sayesinde, yerel macOS ortamında MinIO nesne depolama hizmetini kolayca kurup yönetebilirsiniz. Bu, S3 uyumlu depolamaya ihtiyaç duyan geliştiriciler için hem geliştirme hem de test aşamalarında büyük kolaylık sunar; böylece geliştirme ortamı kurulumu ile vakit kaybetmeden, esas işinize odaklanabilirsiniz.