Monter MinIO sur Linux — Stockage S3 auto-hébergé sur Ubuntu avec NetDrive

Une équipe de build fait tourner son propre cluster MinIO sur un rack de serveurs Ubuntu plutôt que de payer pour du stockage objet managé — caches de couches Docker, fixtures de tests nocturnes, et quelques téraoctets d’artefacts qui n’ont jamais besoin de quitter le réseau du bureau. Les runners CI lisent et écrivent déjà des chemins locaux avec de simples commandes shell, et tout réécrire autour du SDK de MinIO juste pour atteindre un bucket situé trois racks plus loin ressemble à résoudre un problème qui n’a pas besoin de l’être. La version Linux de NetDrive monte le bucket comme un chemin ordinaire à la place, si bien que les scripts existants continuent de fonctionner sans modification.

Monter MinIO sur Ubuntu

Avec NetDrive, Google Drive, OneDrive, S3, SFTP, WebDAV et plus apparaissent comme des lecteurs natifs sur Windows et macOS — sans synchronisation ni téléchargement complet.

• Connexion compatible S3 — fonctionne avec n'importe quel endpoint MinIO auto-hébergé
• Fonctionne sous Ubuntu 16.04 et versions ultérieures
• Les scripts shell existants lisent et écrivent via un point de montage normal

WindowsmacOS

Télécharger NetDrive pour Linux →

Essai gratuit. Licences à vie et abonnements disponibles.

Pourquoi un point de montage l’emporte sur des scripts contre l’API MinIO

Parler directement à MinIO signifie intégrer le client mc ou un SDK S3, gérer la rotation des clés d’accès, et écrire une logique de nouvelle tentative pour le langage utilisé par chaque job. Rien de tout cela n’est difficile, mais c’est du travail d’infrastructure greffé sur une tâche qui consiste en réalité juste à « lire ce fichier, écrire cet autre ». Monter le bucket supprime entièrement cette couche — tar, cp, rsync, et tout ce qui sait déjà toucher un chemin local peut toucher le point de montage de la même façon.

NetDrive traite MinIO comme une connexion compatible S3 bien prise en charge depuis la version 3.15.450 (2021-11-08), la même version qui a ajouté le support général compatible S3 aux côtés d’Amazon S3 lui-même. Sous Linux en particulier, ce type de connexion repose sur la version Ubuntu expérimentale de NetDrive plutôt que sur les versions Windows et macOS bien plus testées — à garder à l’esprit, puisque Linux porte l’étiquette « expérimental » sur la propre page de comparaison de NetDrive.

Ce qu’il faut avant de commencer

• URL de l’endpoint MinIO — quelque chose comme http://minio.internal:9000 pour une machine sur le réseau local, ou une URL HTTPS si le cluster se trouve derrière un reverse proxy. L’API de MinIO écoute sur le port 9000 par défaut ; la console web tourne sur un port distinct et ce n’est pas ce à quoi NetDrive s’adresse.
• Access Key et Secret Key — un compte de service limité au bucket dont NetDrive a besoin, créé depuis la MinIO Console sous Identity → Service Accounts, ou via mc admin user svcacct add. Évitez les identifiants root pour tout ce qui tourne durablement.
• Nom du bucket — NetDrive se connecte au niveau du bucket, donc un serveur qui a besoin de plusieurs buckets obtient une connexion NetDrive distincte pour chacun.
• Ubuntu 16.04 ou ultérieur, avec un accès sortant vers le port de l’endpoint MinIO ouvert sur le pare-feu de la machine.

Installer NetDrive sur Ubuntu

NetDrive pour Linux ne se trouve pas dans les dépôts par défaut d’Ubuntu, l’installation passe donc par GitHub plutôt que par apt :

1. Rendez-vous sur github.com/NetDrive/installer et téléchargez la version correspondant à votre version d’Ubuntu.
2. Vérifiez les notes de cette version avant d’installer — un composant pilote doit se charger en premier, sinon les connexions ne se monteront pas.
3. Installez le paquet, puis lancez NetDrive une fois pour que le pilote se charge. Selon la configuration de la machine, cette étape peut demander sudo.

Étape par étape : connecter un bucket MinIO

1. Ouvrez le Drive Manager de NetDrive et cliquez sur + Add Drive.
2. Sélectionnez Amazon S3 dans la liste des fournisseurs — MinIO parle l’API S3, c’est donc le point d’entrée que NetDrive utilise pour MinIO comme pour les autres stockages compatibles S3.

3. Saisissez l’Access Key ID et la Secret Access Key du compte de service créé précédemment.
4. Définissez Region avec n’importe quelle valeur non vide comme us-east-1 — MinIO l’ignore, mais le champ ne peut pas être vide.
5. Saisissez l’Endpoint — l’URL de l’API MinIO, par exemple http://minio.internal:9000.
6. Saisissez le nom du Bucket à monter.
7. Activez Path style (parfois nommé Force path style). Un MinIO auto-hébergé n’a généralement aucune entrée DNS pour les URL de bucket en style hébergé virtuel, donc l’adressage path-style — où le bucket apparaît comme un segment du chemin — est le réglage qui fonctionne d’emblée.
8. Définissez un point de montage, comme /mnt/minio-artifacts, et cliquez sur Connect.

Vérifier le montage avant qu’un job CI n’en dépende

Confirmez que le montage a bien eu lieu avant de pointer un job non surveillé dessus :

# Confirm the mount is listed
mount | grep minio-artifacts

# Or just list it
ls /mnt/minio-artifacts

Si le répertoire apparaît vide ou que le montage n’apparaît jamais, vérifiez que le pare-feu de la machine autorise le trafic sortant vers le port de l’endpoint MinIO avant de supposer que la clé d’accès est erronée — un port bloqué est une cause plus fréquente sur les serveurs de build verrouillés que de mauvais identifiants.

Ce dont il faut tenir compte avec la version Linux

• Un cycle de publication distinct. Les correctifs livrés pour Windows ou macOS n’arrivent pas automatiquement sur la version Linux la même semaine.
• Aucune intégration apt. Les mises à jour viennent des releases GitHub, pas d’un gestionnaire de paquets, donc suivre les nouvelles versions est une étape manuelle.
• Windows et macOS bénéficient de tests plus poussés. Un runner CI ou un job nocturne lisant depuis MinIO est un cas d’usage raisonnable pour la version Linux ; testez en profondeur avant de mettre un pipeline de production non surveillé derrière elle.

Conclusion

Monter un bucket MinIO auto-hébergé sur Ubuntu donne à un serveur de build le même accès de type lecteur que NetDrive offre sous Windows et macOS, sans réécriture autour du SDK S3. Pour le même fournisseur sur des plateformes plus testées, voir Mount MinIO on Windows ou Mount MinIO on macOS ; pour la vue d’ensemble Linux, voir NetDrive on Ubuntu Linux ; et pour un cas d’usage centré sur la CI construit autour d’un stockage compatible S3, voir DevOps: S3 Test Fixtures with NetDrive.

— Kai, NetDrive