Garage¶

Monta come unità di Windows un bucket su un cluster Garage, uno storage S3 self-hosted leggero.

Prima di iniziare¶

Prepara in anticipo quanto segue:

L'URL del punto finale S3 del tuo cluster Garage.
Una coppia di ID chiave di accesso e Chiave segreta di accesso con accesso al bucket di destinazione.
La regione configurata per il cluster (quella predefinita di Garage è garage).

Dove ottenere le chiavi: sul computer che amministra il cluster:

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

Il primo comando stampa Key ID e Secret key.

Assistenza di Garage

Connessione¶

Fai clic su Aggiungi nella barra degli strumenti.
Scegli Enterprise → Garage.
Inserisci l'URL del punto finale, la Regione, l'ID chiave di accesso e la Chiave segreta di accesso, quindi fai clic sul pulsante di aggiornamento accanto al campo del bucket.
Seleziona il Bucket e fai clic su Connetti.

Inserimento manuale del bucket

Se la tua chiave non è autorizzata a elencare i bucket, seleziona la casella di controllo a sinistra del campo del bucket e digita direttamente il nome del bucket.

Impostazioni¶

Impostazione	Descrizione	Predefinito
Punto finale	URL dell'API S3 di Garage	—
Regione	Valore della regione del cluster (necessario per firmare le richieste)	—
ID chiave di accesso / Chiave segreta di accesso	Coppia di chiavi di Garage	—
Bucket	Il bucket da montare (dall'elenco o inserito manualmente)	—
Sola lettura	Blocca la scrittura sull'unità montata	disattivata

Comportamento e limiti¶

Le connessioni usano l'indirizzamento path-style e vengono accettati certificati TLS privati o autofirmati: adatto a installazioni in LAN e in homelab.

Risoluzione dei problemi¶

Sintomo	Causa	Soluzione
Errori di firma	La regione non corrisponde alla configurazione del cluster	Imposta il campo Regione sul valore `s3_region` del cluster
Elenco dei bucket vuoto	Chiave non autorizzata sul bucket	Autorizza la chiave con `garage bucket allow`, oppure digita manualmente il bucket