Konfigurowanie i używanie usługi przechowywania obiektów MinIO w ServBay
MinIO to wysokowydajny, otwartoźródłowy serwer przechowywania obiektów, kompatybilny z API Amazon S3. Idealnie nadaje się do symulowania usług chmurowych w lokalnym środowisku deweloperskim, umożliwiając przechowywanie i zarządzanie nieustrukturyzowanymi danymi — takimi jak obrazy, wideo, pliki dzienników, kopie zapasowe i obrazy kontenerów. Z pomocą ServBay możesz łatwo wdrożyć i zarządzać lokalną instancją MinIO na macOS.
Przegląd
ServBay oferuje jednorazową instalację MinIO oraz graficzny interfejs konfiguracji, co znacząco upraszcza uruchomienie zgodnego z S3 przechowywania obiektów w środowisku lokalnym. Programista nie musi korzystać z linii poleceń czy złożonych ustawień, wystarczy kilka kliknięć – pełnoprawna usługa przechowywania jest gotowa do użycia przy tworzeniu i testowaniu aplikacji.
Co najważniejsze, ServBay automatycznie konfiguruje bezpieczną i łatwo dostępną internetową konsolę do zarządzania MinIO, dostępną pod adresem https://minio.servbay.host/
.
Wymagania wstępne
- Na Twoim systemie macOS musi być poprawnie zainstalowany i uruchomiony ServBay.
- Podstawowa znajomość pojęć dotyczących przechowywania obiektów (takich jak koszyk/bucket, obiekt/object).
Instrukcja krok po kroku
1. Instalacja pakietu MinIO
Najpierw musisz zainstalować MinIO w ServBay:
- Otwórz aplikację ServBay.
- W lewym panelu nawigacyjnym kliknij Pakiety (Packages).
- Na liście pakietów znajdź sekcję
Przechowywanie obiektów
–MinIO
. - Kliknij przycisk instalacji po prawej stronie
MinIO
i poczekaj na zakończenie instalacji. - Kliknij przycisk włączenia, aby uruchomić usługę
MinIO
.
2. Konfiguracja usługi MinIO
Po zakończeniu instalacji należy przeprowadzić wstępną konfigurację MinIO:
W lewym panelu ServBay kliknij Object Storage.
Z rozwijanego menu wybierz MinIO, aby otworzyć interfejs konfiguracji.
Zobaczysz następujące pola konfiguracyjne, które możesz dostosować lub pozostawić domyślne:
- Bind IP (adres IP): Adres IP, na którym nasłuchuje usługa MinIO. Domyślne
127.0.0.1
oznacza, że usługa jest dostępna tylko lokalnie — to najbezpieczniejszy i rekomendowany wybór dla środowiska deweloperskiego. - API Port (port API): Port komunikacyjny API S3. Twoja aplikacja łączy się przez ten port z MinIO. Domyślnie to
9000
. - Root user (nazwa administratora): Nazwa konta administratora MinIO. Domyślnie
minio
. - Root password (hasło administratora): Hasło konta administratora. Zalecamy ustawienie silnego i unikalnego hasła oraz jego bezpieczne zachowanie. To klucz do zarządzania i dostępu do wszystkich przechowywanych danych.
- Data Path (ścieżka danych): Lokalizacja w systemie plików, gdzie MinIO przechowuje obiekty i metadane. Domyślnie
/Applications/ServBay/data/minio
. Kliknięcie ikony folderu po prawej stronie szybko otwiera ten katalog w Finderze.
- Bind IP (adres IP): Adres IP, na którym nasłuchuje usługa MinIO. Domyślne
3. Zapisz ustawienia i uruchom usługę
- Po zakończonej konfiguracji kliknij przycisk Save (Zapisz) w prawym dolnym rogu.
- Gdy wszystko przebiegnie pomyślnie, wskaźnik statusu zmieni kolor na zielony — MinIO działa prawidłowo.
4. Dostęp do konsoli internetowej MinIO
Jednym z udogodnień ServBay jest automatyczna konfiguracja internetowego panelu zarządzania MinIO:
Sposób 1: W prawym górnym rogu ekranu konfiguracji MinIO kliknij ikonę przeglądarki (przypominającą kompas) — ServBay otworzy konsolę MinIO w domyślnej przeglądarce.
Sposób 2: Ręcznie wpisz w przeglądarce adres
https://minio.servbay.host/
.Zaloguj się używając
Root user
iRoot password
skonfigurowanych w kroku 2.
Po zalogowaniu otrzymujesz intuicyjny interfejs webowy pozwalający zakładać koszyki (Buckets), dodawać oraz zarządzać plikami (Objects), ustawiać polityki dostępu i wiele więcej.
5. Użycie MinIO w aplikacji
Twoja aplikacja (np. PHP, Node.js, Python) może połączyć się z MinIO w ServBay za pomocą dowolnego SDK kompatybilnego z S3. Do poprawnego połączenia potrzebne są poniższe dane:
- Endpoint (adres końcowy):
http://127.0.0.1:9000
- Access Key ID (ID klucza dostępu): Twój
Root user
(np.minio
) - Secret Access Key (tajny klucz dostępu): Twoje
Root password
- Use path style endpoint (użycie ścieżki stylu endpoint): Zaleca się ustawienie na
true
.
Przykład kodu PHP (z użyciem AWS SDK for PHP)
Najpierw zainstaluj SDK:
bash
composer require aws/aws-sdk-php
1
Następnie skonfiguruj i użyj klienta S3 w swoim kodzie:
php
<?php
require 'vendor/autoload.php';
use Aws\S3\S3Client;
use Aws\Exception\AwsException;
$s3Client = new S3Client([
'profile' => 'default',
'version' => 'latest',
'region' => 'us-east-1', // Dla MinIO wartość region może być dowolnym prawidłowym ciągiem znaków
'endpoint' => 'http://127.0.0.1:9000',
'use_path_style_endpoint' => true,
'credentials' => [
'key' => 'minio', // Twój Root user
'secret' => 'your-strong-password', // Twoje Root password
],
]);
try {
$buckets = $s3Client->listBuckets();
foreach ($buckets['Buckets'] as $bucket) {
echo $bucket['Name'] . "\n";
}
} catch (AwsException $e) {
// Wyświetlanie informacji o błędzie
echo "Error: " . $e->getMessage() . "\n";
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Najczęstsze pytania (FAQ)
- Q: Zapomniałem hasła Root password do MinIO, jak je zresetować?
- A: Reset hasła w ServBay jest bardzo prosty. Wystarczy w interfejsie konfiguracji MinIO wprowadzić nowe hasło, kliknąć Save (Zapisz) i ponownie uruchomić usługę MinIO. ServBay zadba o aktualizację plików konfiguracyjnych.
- Q: Usługa MinIO nie uruchamia się. Co robić?
- A: Sprawdź poniższe kwestie:
- Kliknij ikonę dziennika w prawym górnym rogu konfiguracji MinIO i przejrzyj szczegóły błędu.
- Upewnij się, że port
9000
nie jest zajęty przez inną aplikację. - Sprawdź, czy podana ścieżka
Data Path
istnieje oraz czy ServBay ma prawa do odczytu i zapisu w wybranym katalogu.
- A: Sprawdź poniższe kwestie:
- Q: Czy mogę zmienić port API MinIO?
- A: Tak. W ustawieniach konfiguracji MinIO w ServBay zmień pole
API Port
, zapisz zmiany i ponownie uruchom usługę. Pamiętaj, aby zaktualizować port również w aplikacjach korzystających z MinIO.
- A: Tak. W ustawieniach konfiguracji MinIO w ServBay zmień pole
Podsumowanie
Dzięki ServBay skonfigurowanie i uruchomienie lokalnej instancji MinIO na macOS jest wyjątkowo proste. To ogromna wygoda dla deweloperów tworzących i testujących aplikacje wymagające przechowywania zgodnego z S3. Rozwiązanie to pozwala skupić się na logice biznesowej, bez zbędnego tracenia czasu na skomplikowaną konfigurację środowiska.