Configuración y uso del servicio de almacenamiento de objetos MinIO en ServBay

MinIO es un servidor de almacenamiento de objetos de alto rendimiento y código abierto compatible con la API de Amazon S3. Es ideal para simular servicios de almacenamiento en la nube en entornos de desarrollo local, y permite almacenar y gestionar datos no estructurados como imágenes, vídeos, archivos de registro, copias de seguridad e imágenes de contenedores. ServBay facilita el despliegue y gestión de una instancia local de MinIO en macOS.

Descripción general

ServBay ofrece instalación con un solo clic e interfaz gráfica para MinIO, simplificando enormemente la complejidad de implementar almacenamiento compatible con S3 en local. Los desarrolladores pueden disponer rápidamente de un servicio de almacenamiento de objetos completamente funcional para desarrollo y pruebas de aplicaciones, sin necesidad de instalar y configurar desde la línea de comandos.

Además, ServBay configura automáticamente una consola web segura y fácilmente accesible para tu instancia MinIO, con el dominio https://minio.servbay.host/.

Requisitos previos

• Tener ServBay instalado y en funcionamiento en tu sistema macOS.
• Disponer de conocimientos básicos sobre almacenamiento de objetos (conceptos como buckets y objetos).

Pasos de operación

1. Instalar el paquete MinIO

Para empezar, necesitas instalar MinIO dentro de ServBay:

1. Abre la aplicación ServBay.
2. En la barra de navegación lateral, haz clic en Paquetes (Packages).
3. Localiza Almacenamiento de Objetos - MinIO en la lista de paquetes.
4. Haz clic en el botón de instalación junto a MinIO y espera a que finalice el proceso.
5. Haz clic en el botón de activación para habilitar el servicio MinIO.

2. Configurar el servicio MinIO

Después de la instalación, es necesario realizar la configuración inicial de MinIO:

1. En la barra de navegación lateral de ServBay, haz clic en Object Storage.

2. Selecciona MinIO en el menú desplegable para acceder a la interfaz de configuración.

   

3. Verás las siguientes opciones de configuración, que puedes modificar según tus necesidades o dejar con los valores por defecto:

   • Bind IP (IP de enlace): Dirección IP en la que el servicio MinIO escuchará. El valor predeterminado 127.0.0.1 significa que solo estará accesible desde la propia máquina, lo cual es la configuración más segura y recomendada para desarrollo local.
   • API Port (Puerto API): Puerto de comunicación de la API S3. Tu aplicación se conectará a MinIO a través de este puerto. El valor por defecto es 9000.
   • Root user (Usuario root): Nombre de usuario de la cuenta administradora de MinIO. Por defecto es minio.
   • Root password (Contraseña root): Contraseña de la cuenta de administrador. Se recomienda encarecidamente establecer una contraseña compleja y única, y guardarla de forma segura. Es clave para acceder y gestionar todos tus datos almacenados.
   • Data Path (Ruta de datos): Ruta en el sistema de archivos local donde MinIO almacena todos los objetos y metadatos. Por defecto es /Applications/ServBay/data/minio. Puedes hacer clic en el icono de carpeta a la derecha para abrir este directorio rápidamente en Finder.

3. Guardar la configuración e iniciar el servicio

1. Una vez hayas terminado la configuración, haz clic en el botón Guardar (Save) en la esquina inferior derecha.
2. Si todo está correcto, el indicador de estado del servicio se pondrá verde, señalando que MinIO se está ejecutando satisfactoriamente.

4. Acceder a la consola web de MinIO

Una de las mayores facilidades que ofrece ServBay es que ya ha configurado automáticamente la interfaz web de administración de MinIO:

1. Primer método: En la esquina superior derecha de la interfaz de configuración de MinIO, haz clic en el icono del navegador (con forma de brújula) y ServBay abrirá automáticamente la consola de MinIO en tu navegador predeterminado.

2. Segundo método: Abre manualmente en tu navegador https://minio.servbay.host/.

   

3. Inicia sesión usando el Root user y Root password configurados en el paso 2.

Una vez dentro, podrás crear buckets, subir y administrar archivos (objetos), definir políticas de acceso y más, todo desde esta intuitiva interfaz web.

5. Usar MinIO en tus aplicaciones

Tus aplicaciones (por ejemplo, en PHP, Node.js, Python, etc.) pueden conectar con la instancia de MinIO en ServBay usando cualquier SDK compatible con S3. Necesitarás la siguiente información clave:

• Endpoint (Punto de acceso): http://127.0.0.1:9000
• Access Key ID (ID de clave de acceso): Tu Root user configurado (por ejemplo minio)
• Secret Access Key (Clave de acceso secreta): Tu Root password configurada
• Use path style endpoint (Usar endpoint de tipo ruta): Se recomienda encarecidamente establecer esto en true.

Ejemplo de código PHP (usando AWS SDK for PHP)

Primero, instala el SDK:

composer require aws/aws-sdk-php

Luego, configura y usa el cliente S3 en tu código:

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

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

$s3Client = new S3Client([
    'profile' => 'default',
    'version'     => 'latest',
    'region'      => 'us-east-1', // Para MinIO, la región puede ser cualquier cadena válida
    'endpoint'    => 'http://127.0.0.1:9000',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => 'minio', // Tu usuario root
        'secret' => 'your-strong-password', // Tu contraseña root
    ],
]);

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

Preguntas frecuentes (FAQ)

• P: He olvidado la contraseña de root de MinIO, ¿cómo la restablezco?
  • R: Es muy sencillo restablecer la contraseña en ServBay. Solo tienes que introducir una nueva contraseña en la interfaz de configuración de MinIO, hacer clic en Guardar (Save) y luego reiniciar el servicio MinIO. ServBay actualizará automáticamente el archivo de configuración.
• P: El servicio MinIO no inicia, ¿qué puedo hacer?
  • R: Verifica lo siguiente:
    1. Haz clic en el icono de registro en la esquina superior derecha de la interfaz de configuración de MinIO para revisar mensajes de error detallados.
    2. Asegúrate de que el puerto 9000 no esté siendo usado por otra aplicación.
    3. Comprueba que la Data Path especificada existe y que ServBay tiene permisos de lectura y escritura en ese directorio.
• P: ¿Puedo cambiar el puerto de la API de MinIO?
  • R: Sí, puedes hacerlo. Solo modifica el campo API Port en la interfaz de configuración de MinIO en ServBay, guarda los cambios y reinicia el servicio. Asegúrate también de que tus aplicaciones se conecten al nuevo puerto.

Resumen

Gracias a ServBay, configurar y ejecutar una instancia local de MinIO en macOS nunca ha sido tan sencillo. Esto facilita enormemente el desarrollo y las pruebas de aplicaciones que requieren almacenamiento compatible con S3, permitiendo a los desarrolladores centrarse en la lógica de negocio sin tener que preocuparse en exceso por la configuración del entorno.