MinIO Objectopslagservice Configureren en Gebruiken in ServBay

MinIO is een krachtige, open source objectopslagserver compatible met de Amazon S3 API. Het is bij uitstek geschikt om in een lokale ontwikkelomgeving cloudopslag te simuleren voor het opslaan en beheren van ongestructureerde data, zoals afbeeldingen, video’s, logbestanden, back-ups en containerimages. Met ServBay kun je eenvoudig een lokale MinIO-instantie op macOS implementeren en beheren.

Overzicht

ServBay biedt een one-click installatie en grafische configuratie-interface voor MinIO, waarmee je eenvoudig een S3-compatibele opslagomgeving lokaal opzet. Ontwikkelaars hoeven zich niet bezig te houden met ingewikkelde commandline-installaties en kunnen snel gebruikmaken van een volwaardige objectopslagservice voor applicatieontwikkeling en -testen.

Bovendien configureert ServBay automatisch een veilige en eenvoudig toegankelijke webconsole voor jouw MinIO-instance, bereikbaar via het domein https://minio.servbay.host/.

Benodigdheden

• Je hebt ServBay succesvol geïnstalleerd en draaiend op je macOS-systeem.
• Je hebt basiskennis van objectopslagconcepten zoals Buckets en Objects.

Stappenplan

1. MinIO-pakket installeren

Installeer MinIO in ServBay als volgt:

1. Open de ServBay-applicatie.
2. Klik in de linker navigatiebalk op Pakketten (Packages).
3. Zoek in de lijst het onderdeel Objectopslag - MinIO.
4. Klik op de installatiesknop rechts naast MinIO en wacht tot de installatie klaar is.
5. Klik op de knop om MinIO te activeren en de dienst in te schakelen.

2. MinIO-dienst configureren

Voer na installatie de initiële configuratie uit:

1. Klik in de linker navigatiebalk van ServBay op Object Storage.

2. Kies in het dropdownmenu MinIO om het configuratiescherm te openen.

   

3. Je ziet de volgende instellingen, die je desgewenst kunt aanpassen of standaard kunt laten:

   • Bind IP (Bind IP-adres): Het IP-adres waarop MinIO luistert. Standaard is dit 127.0.0.1, wat betekent dat de opslag alleen lokaal toegankelijk is; dit is het veiligste en aanbevolen voor lokale ontwikkeling.
   • API Port (API-poort): De poort voor S3 API-communicatie. Je applicatie verbindt via deze poort met MinIO. Standaard ingesteld op 9000.
   • Root user (Beheerder): Gebruikersnaam van het MinIO-beheerdersaccount. Standaardwaarde is minio.
   • Root password (Beheerderswachtwoord): Wachtwoord voor het beheeraccount. We raden sterk aan om een complex en uniek wachtwoord te kiezen en veilig te bewaren. Dit is essentieel voor toegang tot en beheer van alle opgeslagen data.
   • Data Path (Datapad): Het lokale bestandssysteem waar MinIO alle objecten en metadata opslaat. Standaard is dit /Applications/ServBay/data/minio. Klik op het mapicoon aan de rechterkant om de locatie snel in Finder te openen.

3. Configuratie opslaan en dienst starten

1. Als de configuratie voltooid is, klik je rechtsonder op Opslaan (Save).
2. Gaat alles goed, dan wordt het statuslampje groen waarmee MinIO succesvol draait.

4. Toegang tot de MinIO Webconsole

Een groot voordeel van ServBay is de automatisch geconfigureerde webinterface voor MinIO-beheer:

1. Methode 1: Klik in de rechterbovenhoek van het MinIO-configuratiescherm op het browsericoon (lijkt op een kompas). ServBay opent direct de MinIO-console in je standaardbrowser.

2. Methode 2: Vul handmatig https://minio.servbay.host/ in je webbrowser in.

   

3. Log in met de door jou bij stap 2 ingestelde Root user en Root password.

Na het inloggen kun je via deze intuïtieve webinterface buckets aanmaken, bestanden uploaden en beheren, toegangsrechten instellen, enzovoort.

5. MinIO gebruiken in je applicatie

Jouw applicatie (zoals PHP, Node.js, Python, etc.) kan verbinding maken met de lokale MinIO-instantie in ServBay via elke S3-compatibele SDK. Hiervoor heb je deze kerngegevens nodig:

• Endpoint: http://127.0.0.1:9000
• Access Key ID: De door jou ingestelde Root user (bijvoorbeeld minio)
• Secret Access Key: Het ingestelde Root password
• Gebruik path style endpoint: Stel dit sterk aanbevolen in op true.

PHP Voorbeeldcode (met AWS SDK for PHP)

Installeer eerst de SDK:

composer require aws/aws-sdk-php

Configureer en gebruik daarna de S3-client in je code:

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

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

$s3Client = new S3Client([
    'profile' => 'default',
    'version'     => 'latest',
    'region'      => 'us-east-1', // Voor MinIO mag dit een willekeurige geldige string zijn
    'endpoint'    => 'http://127.0.0.1:9000',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => 'minio', // Jouw Root user
        'secret' => 'your-strong-password', // Jouw Root password
    ],
]);

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

Veelgestelde Vragen (FAQ)

• Q: Ik ben het Root password van MinIO vergeten. Hoe kan ik dit resetten?
  • A: In ServBay is het resetten eenvoudig. Voer een nieuw wachtwoord in bij het MinIO-configuratiescherm, klik op Opslaan (Save) en herstart vervolgens de dienst. ServBay past het configuratiebestand automatisch aan.
• Q: De MinIO-dienst start niet, wat kan ik doen?
  • A: Controleer het volgende:
    1. Klik rechtsboven in het MinIO-configuratiescherm op het logboekicoon om de exacte foutmelding te bekijken.
    2. Zorg dat poort 9000 niet door een ander programma in gebruik is.
    3. Check of het opgegeven Datapad bestaat en of ServBay lees- en schrijfrechten op deze map heeft.
• Q: Kan ik de API-poort van MinIO wijzigen?
  • A: Ja. Pas in het MinIO-configuratiescherm van ServBay het veld API Port aan, sla op en herstart de dienst. Vergeet niet het nieuwe poortnummer ook in je applicaties te gebruiken.

Samenvatting

Met ServBay is het nog nooit zo eenvoudig geweest om een lokale MinIO-objectopslaginstantie op macOS te configureren en te draaien. Dit biedt maximale flexibiliteit en gemak voor lokale applicatieontwikkeling en -testen die S3-compatibele opslag vereist, zodat ontwikkelaars zich kunnen concentreren op hun kernfunctionaliteit en niet op ingewikkelde omgevingsconfiguraties.