Настройка и использование MinIO объектного хранилища в ServBay

MinIO — это высокопроизводительный open source-сервер объектного хранения, совместимый с Amazon S3 API. Он идеально подходит для эмуляции облачного хранилища в локальной среде разработки и используется для хранения и управления неструктурированными данными, такими как изображения, видео, лог-файлы, резервные копии и образы контейнеров. С помощью ServBay вы можете легко развернуть и управлять локальным экземпляром MinIO на macOS.

Обзор

ServBay предоставляет установку MinIO в один клик и графический интерфейс настройки, значительно упрощая локальное развертывание S3-совместимого хранилища. Разработчикам не нужно разбираться с командной строкой: полноценное решение для хранения объектов доступно быстро — для разработки и тестирования приложений.

Кроме того, ServBay автоматически настраивает для вашей инстанции MinIO защищенную и простую в доступе веб-консоль по адресу https://minio.servbay.host/.

Необходимые условия

• На вашем macOS установлен и запущен ServBay.
• Вы знакомы с базовыми понятиями объектного хранения (например, Bucket — бакет, Object — объект).

Пошаговая инструкция

1. Установка MinIO-пакета

Сначала нужно установить MinIO через ServBay:

1. Откройте приложение ServBay.
2. В левом меню перейдите к разделу Пакеты (Packages).
3. Найдите в списке пакетов пункт Объектное хранилище — MinIO.
4. Нажмите кнопку установки справа от MinIO и дождитесь завершения процесса.
5. Нажмите кнопку активации, чтобы включить сервис MinIO.

2. Настройка MinIO

После установки необходимо выполнить первичную настройку MinIO:

1. В левом меню ServBay выберите Object Storage.

2. В выпадающем списке выберите MinIO, чтобы перейти на страницу его настроек.

   

3. Вы увидите следующие параметры, которые можно оставить по умолчанию или изменить в соответствии с вашими требованиями:

   • Bind IP (Привязка IP): IP-адрес, на котором MinIO слушает подключения. Значение по умолчанию — 127.0.0.1, это означает доступ только с локального компьютера и является самым безопасным и рекомендуемым вариантом для локальной разработки.
   • API Port (API-порт): Порт для коммуникации с S3 API. Ваше приложение будет подключаться к MinIO через этот порт. По умолчанию — 9000.
   • Root user (Админ-пользователь): Имя администратора MinIO. По умолчанию — minio.
   • Root password (Админ-пароль): Пароль администратора. Настоятельно рекомендуется задать сложный уникальный пароль и хранить его в безопасности, так как он обеспечивает доступ и управление всеми вашими данными.
   • Data Path (Путь к данным): Путь на локальной файловой системе, где MinIO хранит объекты и метаданные. По умолчанию — /Applications/ServBay/data/minio. Вы можете быстро открыть эту папку в Finder, нажав на значок папки справа.

3. Сохранение настроек и запуск сервиса

1. Завершив настройку, нажмите кнопку Сохранить (Save) в правом нижнем углу.
2. Если всё прошло успешно, индикатор состояния сервиса станет зелёным — MinIO запущен.

4. Доступ к веб-консоли MinIO

Одна из главных фишек ServBay — это автоматическая настройка веб-интерфейса управления MinIO:

1. Способ 1: В верхнем правом углу страницы настроек MinIO кликните на значок браузера (он выглядит как компас) — ServBay откроет консоль MinIO в вашем браузере.

2. Способ 2: Вручную введите в браузере адрес https://minio.servbay.host/.

   

3. Войдите с Root user и Root password, которые вы задали на шаге 2.

После входа вы сможете через удобный веб-интерфейс создавать бакеты (Buckets), загружать и администрировать файлы (Objects), а также управлять политиками доступа.

5. Использование MinIO в приложении

Ваши приложения (например, на PHP, Node.js, Python и т.д.) могут подключаться к MinIO в ServBay через любой SDK с поддержкой S3-протокола. Для подключения необходимы следующие данные:

• Endpoint (Эндпоинт): http://127.0.0.1:9000
• Access Key ID (ID ключа доступа): Ваш Root user (например, minio)
• Secret Access Key (Секретный ключ): Ваш Root password
• Использовать path style endpoint: Настоятельно рекомендуется задать true.

Пример PHP-кода (AWS SDK для PHP)

Сначала установите SDK:

composer require aws/aws-sdk-php

Затем настройте и используйте клиент 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', // Для MinIO region может быть любой валидной строкой
    'endpoint'    => 'http://127.0.0.1:9000',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => 'minio', // Ваш Root user
        'secret' => 'your-strong-password', // Ваш Root password
    ],
]);

try {
    $buckets = $s3Client->listBuckets();
    foreach ($buckets['Buckets'] as $bucket) {
        echo $bucket['Name'] . "\n";
    }
} catch (AwsException $e) {
    // Вывести сообщение об ошибке
    echo "Ошибка: " . $e->getMessage() . "\n";
}

Часто задаваемые вопросы (FAQ)

• В: Я забыл Root password для MinIO, как сбросить?
  • О: В ServBay это делается предельно просто — откройте настройки MinIO, введите новый пароль, нажмите Сохранить (Save) и перезапустите сервис MinIO. ServBay автоматически обновит конфиг.
• В: MinIO не запускается. Что делать?
  • О: Проверьте следующее:
    1. Кликните на значок журнала в правом верхнем углу страницы настройки MinIO и посмотрите на сообщение об ошибке.
    2. Убедитесь, что порт 9000 не занят другим приложением.
    3. Проверьте, существует ли указанный Data Path и есть ли у ServBay права на чтение и запись в эту папку.
• В: Можно ли изменить API-порт MinIO?
  • О: Да. Для этого в настройках MinIO в ServBay измените поле API Port, сохраните изменения и перезапустите сервис. Не забудьте скорректировать порт в настройках своих приложений.

Итоги

С помощью ServBay настройка и запуск локального экземпляра MinIO на macOS становится элементарной задачей. Это идеальное решение для быстрого создания и тестирования приложений с S3-совместимым хранилищем, позволяющее разработчикам сосредоточиться на бизнес-логике, не тратя время на конфигурацию среды.