MinIO unter Linux einbinden — Self-Hosted S3 mit NetDrive

Ein Build-Team betreibt seinen eigenen MinIO-Cluster auf einem Rack aus Ubuntu-Servern, statt für verwalteten Object Storage zu bezahlen — Docker-Layer-Caches, nächtliche Testfixtures und ein paar Terabyte an Artefakten, die das Büronetz nie verlassen müssen. Die CI-Runner lesen und schreiben bereits lokale Pfade mit einfachen Shell-Befehlen, und den Code rund um MinIOs SDK neu zu schreiben, nur um einen Bucket zu erreichen, der drei Racks weiter steht, fühlt sich an wie die Lösung eines Problems, das keine Lösung braucht. NetDrives Linux-Build bindet den Bucket stattdessen als gewöhnlichen Pfad ein, sodass die vorhandenen Skripte unverändert weiterlaufen.

MinIO unter Ubuntu einbinden

Mit NetDrive erscheinen Google Drive, OneDrive, S3, SFTP, WebDAV und mehr als native Laufwerke unter Windows und macOS — ohne Synchronisation, ohne vollständige Downloads.

• S3-kompatible Verbindung — funktioniert mit jedem selbst gehosteten MinIO-Endpoint
• Läuft auf Ubuntu 16.04 und neuer
• Vorhandene Shell-Skripte lesen und schreiben über einen normalen Mountpoint

WindowsmacOS

NetDrive für Linux herunterladen →

Kostenlose Testversion. Lifetime- und Abo-Pläne verfügbar.

Warum ein Mountpoint besser ist als Skripting gegen die MinIO-API

Direkt mit MinIO zu sprechen bedeutet, den mc-Client oder ein S3-SDK einzubinden, die Rotation der Access Keys zu handhaben und Retry-Logik für die jeweilige Sprache eines Jobs zu schreiben. Nichts davon ist schwer, aber es ist Infrastrukturarbeit, die auf eine Aufgabe geschraubt wird, die im Kern nur “diese Datei lesen, jene Datei schreiben” ist. Das Einbinden des Buckets entfernt diese Schicht komplett — tar, cp, rsync und alles andere, das bereits weiß, wie man einen lokalen Pfad anfasst, kann den Mountpoint genauso anfassen.

NetDrive behandelt MinIO seit Version 3.15.450 (08.11.2021) als gut unterstützte S3-kompatible Verbindung — derselben Version, die allgemeine S3-kompatible Unterstützung neben Amazon S3 selbst einführte. Unter Linux läuft dieser Verbindungstyp speziell auf NetDrives experimentellem Ubuntu-Build statt auf den deutlich stärker getesteten Windows- und macOS-Releases — gut zu wissen im Voraus, denn Linux trägt auf NetDrives eigener Vergleichsseite das Label “experimentell”.

Was vor dem Start benötigt wird

• MinIO-Endpoint-URL — etwa http://minio.internal:9000 für eine Maschine im lokalen Netz, oder eine HTTPS-URL, wenn der Cluster hinter einem Reverse-Proxy sitzt. Die API von MinIO lauscht standardmäßig auf Port 9000; die Web-Konsole läuft auf einem separaten Port und ist nicht das, womit NetDrive spricht.
• Access Key und Secret Key — ein Service-Account, der auf den Bucket beschränkt ist, den NetDrive braucht, erstellt über die MinIO-Konsole unter Identity → Service Accounts oder via mc admin user svcacct add. Root-Credentials für alles Langlebige vermeiden.
• Bucket-Name — NetDrive verbindet sich auf Bucket-Ebene, sodass ein Server, der mehrere Buckets braucht, für jeden eine eigene NetDrive-Verbindung bekommt.
• Ubuntu 16.04 oder neuer, mit ausgehendem Zugriff auf den Port des MinIO-Endpoints, freigegeben in der Firewall der Maschine.

NetDrive unter Ubuntu installieren

NetDrive für Linux liegt nicht in Ubuntus Standard-Repositories, daher läuft die Einrichtung über GitHub statt über apt:

1. Zu github.com/NetDrive/installer gehen und das Release herunterladen, das zur eigenen Ubuntu-Version passt.
2. Vor der Installation die Release-Notes prüfen — eine Treiberkomponente muss zuerst laden, sonst mounten Verbindungen nicht.
3. Das Paket installieren, dann NetDrive einmal starten, damit der Treiber lädt. Je nach Einrichtung der Maschine fragt dieser Schritt nach sudo.

Schritt für Schritt: Einen MinIO-Bucket verbinden

1. NetDrives Drive Manager öffnen und auf + Add Drive klicken.
2. Amazon S3 aus der Anbieterliste auswählen — MinIO spricht die S3-API, daher ist dies der Einstiegspunkt, den NetDrive für MinIO wie auch für andere S3-kompatible Speicher nutzt.

3. Access Key ID und Secret Access Key des zuvor erstellten Service-Accounts eingeben.
4. Region auf einen beliebigen nicht leeren Wert wie us-east-1 setzen — MinIO ignoriert ihn, aber das Feld darf nicht leer sein.
5. Endpoint eingeben — die MinIO-API-URL, zum Beispiel http://minio.internal:9000.
6. Bucket-Namen zum Einbinden eingeben.
7. Path style aktivieren (manchmal als Force path style bezeichnet). Selbst gehostetes MinIO hat meist keinen DNS-Eintrag für virtuell gehostete Bucket-URLs, daher ist Path-Style-Adressierung — bei der der Bucket als Pfadsegment erscheint — die Einstellung, die sofort funktioniert.
8. Mountpoint festlegen, etwa /mnt/minio-artifacts, und auf Connect klicken.

Den Mount prüfen, bevor ein CI-Job sich darauf verlässt

Bestätigen, dass der Mount tatsächlich erfolgt ist, bevor ein unbeaufsichtigter Job darauf zeigt:

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

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

Erscheint das Verzeichnis leer oder taucht der Mount gar nicht auf, zuerst prüfen, ob die Firewall der Maschine ausgehenden Traffic zum Port des MinIO-Endpoints erlaubt, bevor ein falscher Access Key vermutet wird — ein blockierter Port ist auf abgeschotteten Build-Servern eine häufigere Ursache als falsche Credentials.

Worauf man sich beim Linux-Build einstellen sollte

• Ein separater Release-Rhythmus. Fixes, die für Windows oder macOS erscheinen, landen nicht automatisch in derselben Woche auch im Linux-Build.
• Keine apt-Integration. Updates kommen aus GitHub-Releases, nicht aus einem Paketmanager, daher ist das Verfolgen neuer Versionen ein manueller Schritt.
• Windows und macOS erhalten die tiefere Testabdeckung. Ein CI-Runner oder ein nächtlicher Job, der von MinIO liest, passt gut zum Linux-Build; vor dem Einsatz in einer unbeaufsichtigten Produktionspipeline gründlich testen.

Fazit

Das Einbinden eines selbst gehosteten MinIO-Buckets unter Ubuntu gibt einem Build-Server denselben laufwerksartigen Zugriff, den NetDrive unter Windows und macOS bietet, ohne eine Neuentwicklung rund um das S3-SDK. Für denselben Anbieter auf stärker getesteten Plattformen siehe Mount MinIO on Windows oder Mount MinIO on macOS; für das größere Linux-Bild siehe NetDrive on Ubuntu Linux; und für einen CI-fokussierten Anwendungsfall rund um S3-kompatiblen Speicher siehe DevOps: S3 Test Fixtures with NetDrive.

— Kai, NetDrive