Garage¶

Montez un bucket d'un cluster Garage (un stockage S3 léger et auto-hébergé) comme lecteur Windows.

Avant de commencer¶

Préparez à l'avance les éléments suivants :

L'URL du point de terminaison S3 de votre cluster Garage.
Une paire ID de la clé d'accès et Clé d'accès secrète ayant accès au bucket cible.
La région configurée pour le cluster (la valeur par défaut de Garage est garage).

Où obtenir les clés — sur la machine qui administre le cluster :

garage key create raidrive-key
garage bucket allow --read --write YOUR-BUCKET --key raidrive-key

La première commande affiche le Key ID et la Secret key.

Aide de Garage

Cliquez sur Ajouter dans la barre d'outils.
Choisissez Enterprise → Garage.
Saisissez l'URL du point de terminaison, la Région, l'ID de la clé d'accès et la Clé d'accès secrète, puis cliquez sur le bouton Actualiser à côté du champ du bucket.
Sélectionnez le Bucket et cliquez sur Connexion.

Saisie manuelle du bucket

Si votre clé n'est pas autorisée à lister les buckets, cochez la case à gauche du champ du bucket et saisissez directement le nom du bucket.

Paramètre	Description	Par défaut
Point de terminaison	URL de l'API S3 de Garage	—
Région	Valeur de région du cluster (nécessaire à la signature des requêtes)	—
ID de la clé d'accès / Clé d'accès secrète	Paire de clés Garage	—
Bucket	Le bucket à monter (liste ou saisie manuelle)	—
Lecture seule	Bloque les écritures sur le lecteur monté	désactivé

Les connexions utilisent l'adressage en mode chemin (path-style), et les certificats TLS privés ou auto-signés sont acceptés : adapté aux déploiements sur réseau local et en homelab.

Symptôme	Cause	Solution
Erreurs de signature	La région ne correspond pas à la configuration du cluster	Renseignez le champ Région avec la valeur `s3_region` du cluster
Liste des buckets vide	La clé n'a pas d'accès au bucket	Autorisez la clé avec `garage bucket allow`, ou saisissez le bucket manuellement