Trabajar con MinIO en local

Para trabajar con MinIO en un PC local, bien para corregir algún bug o bien para añadir una nueva funcionalidad, es necesario desplegar:

Servidor de MinIO.
Consola de navegación del usuario MinIO sin privilegios.
Consola de administrador de MinIO.
NGINX para acceder a MinIO por protocolo HTTPs desde el control panel de la plataforma.

A partir de la release 3.2.2, se proporciona un docker-compose para facilitar esta tarea, de manera que es posible arrancarlo todo con Docker de forma integrada.

El docker-compose de MinIO se encuentra dentro del código fuente de la plataforma en:

onesait-cloud-platform/devops/buil-deploy/docker/modules/minio

Como paso previo al arranque de los servicios de MinIO en el PC local, es necesario configurar dos cosas:

Fichero etc/hosts para poder acceder a los servicios de MinIO desde el control panel local por HTTPs: Dentro del docker-compose de MinIO, se levanta un NGINX por protocolo seguro en el puerto 443. Dicho NGINX viene configurado con un certificado autofirmado para el nombre de máquina devonesaitplatform.com que se tendrá que resolver a la IP de tu propio PC, que es donde estárán corriendo los servicios de MinIO. Por lo que en el fichero etc/hosts hay que crear las siguientes entradas:
- <IP_máquina_local> devonesaitplatform.com
- <IP_máquina_local> minio-console.devonesaitplatform.com
- <IP_máquina_local> minio-browser.devonesaitplatform.com

Configurar en el NGINX la redirección al control-panel de tu máquina loca. Para ello, hay que editar el fichero onesait-cloud-platform/devops/buil-deploy/docker/modules/minio/nginx/conf.d/default.conf y modificar la IP del proxy_pass al control panel a nuestra propia IP:

Una vez configurado, puedes arrancar y detener los servicios de MinIO en local mediante:

docker-compose up -d
docker-compose down

Examinando el fichero docker-compose, puedes observar que ha mapeado el servicio de MinIO al puerto 9000 de tu máquina y los servicios de las consolas de MinIO estarían redirigidos desde el NGINX.

A partir de la versión 3.2.2, se proporciona el config-init configurado para poder utilizar la configuración del docker-compose. Si se utiliza una versión anterior de plataforma habrá que editar la configuración de Endpoint Modules en la sección correspondiente a MinIO para dejarla así:

minio: 
      base: http://localhost:9000
      admin:
         internal: https://minio-console.devonesaitplatform.com
         external: https://minio-console.devonesaitplatform.com
      browser:
         internal: https://minio-browser.devonesaitplatform.com
         external: https://minio-browser.devonesaitplatform.com
      cookiedomain: devonesaitplatform.com

Un problema conocido es que la primera vez que se accede desde el control-panel a MinIO, no se carga correctamente, apareciendo el iframe donde se debería de cargar con un error. Esto se debe al certificado autofirmado. Para corregirlo habría que abrir en otra ventana del navegador la url minio-browser.devonesaitplatform.com y añadir la excepción al certificado. A partir de ese momento se cargará la pantalla correctamente.

Una vez arrancado, hay que entrar al Controlpanel a través del balanceador: https://devonesaitplatform.com/controlpanel

platform-doc-es

Trabajar con MinIO en local

Related content