Obsolète : MinIO

Introduction #

minIO est une solution de stockage objet évolutive et performante. Dans Relution, la table resource peut devenir très volumineuse (par exemple en raison des applications natives enregistrées). Pour soulager la base de données, il est recommandé de déplacer ces fichiers d’application dans un bucket S3.

L’image minIO est un conteneur Docker compact et facilement configurable.

Préparation du docker-compose.yml #

Ajouter un conteneur minIO dans le docker-compose.yml :

services:
  minio:
    image: "quay.io/minio/minio:latest"
    restart: always
    ports:
      - "9001:9001"
    expose:
      - 9000
    environment:
      MINIO_ROOT_USER: "%USERNAME%"
      MINIO_ROOT_PASSWORD: "%PASSWORD%"
    command: server --console-address ":9001" /data
    networks:
      relution-network:
        aliases:
          - minio
    volumes:
      - ./volumes/minio/data:/data

• Remplacer MINIO_ROOT_USER et MINIO_ROOT_PASSWORD par des valeurs propres.
• Les données seront stockées localement sous ./volumes/minio/data.

Configuration initiale de minIO #

1. Démarrer le conteneur et ouvrir l’interface web de minIO : 👉 http://localhost:9001 →

2. Se connecter avec les identifiants configurés.

3. Effectuer les étapes suivantes :

   • Créer un nouveau bucket nommé relution

Configurer Relution #

Relution doit savoir que les données seront désormais stockées dans le bucket S3.

Option A : dans application.yml #

Ajouter ces paramètres de configuration dans application.yml :

relution:
  storage:
    resourceStorageType: S3
    s3:
      customEndpoint: http://minio:9000
      accessKey: %ACCESS-KEY-ID%
      secretKey: %SECRET-KEY%
      bucketName: relution

Remplacer %ACCESS-KEY-ID% et %SECRET-KEY% par les valeurs générées précédemment dans le yml, MINIO_ROOT_USER=%USERNAME% et MINIO_ROOT_PASSWORD=%PASSWORD%.

Option B : dans docker-compose.yml #

Ajouter ces variables d’environnement au service relution :

services:
  relution:
    environment:
      RELUTION_STORAGE_RESOURCESTORAGETYPE: "S3"
      RELUTION_STORAGE_S3_CUSTOMENDPOINT: "http://minio:9000"
      RELUTION_STORAGE_S3_ACCESSKEY: "%ACCESS-KEY-ID%"
      RELUTION_STORAGE_S3_SECRETKEY: "%SECRET-KEY%"
      RELUTION_STORAGE_S3_BUCKETNAME: "relution"

Remplacer %ACCESS-KEY-ID% et %SECRET-KEY% par les valeurs générées précédemment dans le yml, MINIO_ROOT_USER=%USERNAME% et MINIO_ROOT_PASSWORD=%PASSWORD%.

Démarrer les conteneurs #

1. Télécharger les images :

   docker compose pull
   

2. Démarrer les conteneurs :

   docker compose up -d
   

• minIO sera opérationnel en quelques secondes.
• Relution commence automatiquement à déplacer le contenu de la table resource vers le bucket S3.

Surveiller la progression #

Le processus de copie peut être observé avec la commande suivante :

docker logs -f docker_relution

Remarque #