Scopri come montare un bucket Cloud Storage come file system locale utilizzando Cloud Storage FUSE, in modo da poter interagire con i tuoi oggetti utilizzando la semantica standard del file system.
In questa guida rapida, completerai le attività seguenti:
Installare Cloud Storage FUSE su Debian o Ubuntu
Monta il bucket come cartella sulla macchina
Carica un oggetto nel bucket
Utilizzerai l'interfaccia a riga di comando Google Cloud CLI per creare e gestire l'oggetto nel bucket di archiviazione, mentre utilizzerai l'interfaccia a riga di comando gcsfuse per montare il bucket sulla macchina.
Prima di iniziare
Per configurare un progetto, completa i seguenti passaggi:
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
Nella pagina del selettore di progetti della console Google Cloud, fai clic su Crea progetto per iniziare a creare un nuovo progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Nella pagina del selettore di progetti della console Google Cloud, fai clic su Crea progetto per iniziare a creare un nuovo progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
- Disporre di un bucket Cloud Storage da montare. Se non ne hai già uno, crea un nuovo bucket.
Installa Cloud Storage FUSE
Per installare Cloud Storage FUSE, completa le seguenti istruzioni utilizzando la tua shell locale su Debian o Ubuntu:
Aggiungi l'URL di distribuzione di Cloud Storage FUSE come origine del pacchetto:
export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
echo "deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list
Importa la chiave pubblica del repository APT di Google Cloud:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Aggiorna l'elenco dei pacchetti disponibili:
sudo apt-get update
Installa Cloud Storage FUSE e la sua dipendenza FUSE:
sudo apt-get install fuse gcsfuse
Quando richiesto, premi Invio per confermare.
Verifica che Cloud Storage FUSE sia stato installato:
gcsfuse -v
Se l'esito è positivo, il comando restituisce un output simile al seguente:
gcsfuse version 0.41.12 (Go version go1.18.4)
Monta il bucket
Per montare il bucket sul tuo file system locale, segui questi passaggi:
Genera credenziali predefinite dell'applicazione utilizzando il comando
gcloud auth application-default login
:gcloud auth application-default login
Cloud Storage FUSE carica automaticamente le credenziali.
Crea una directory in cui montare il bucket di archiviazione:
mkdir "$HOME/mount-folder"
Monta il bucket di archiviazione utilizzando il comando
gcsfuse
:gcsfuse BUCKET_NAME "$HOME/mount-folder"
Sostituisci BUCKET_NAME con il nome del bucket che vuoi montare.
Se l'esito è positivo, il comando restituisce un output che contiene un testo simile al seguente:
File system has been successfully mounted.
Carica un oggetto nel bucket
Per scaricare un oggetto di esempio e caricarlo nel bucket montato, completa questi passaggi:
Fai clic con il pulsante destro del mouse sull'immagine qui sopra e salvala da qualche parte sul computer, ad esempio sul desktop.
Puoi anche scaricare l'immagine utilizzando il comando cURL
curl -O https://cloud.google.com/storage/images/kitten.png
.Copia l'immagine dalla posizione salvata nella cartella in cui è montato il bucket, utilizzando il comando
cp
:cp kitten.png "$HOME/mount-folder/kitten.png"
Verifica che l'immagine sia stata copiata nel file system locale e caricata correttamente nel bucket seguendo questi passaggi:
Per verificare che
kitten.png
sia stato copiato nel file system locale, eseguils
nella cartella in cui è montato il bucket:ls "$HOME/mount-folder"
Se l'operazione di copia è riuscita, nell'output viene restituito
kitten.png
.Per elencare i contenuti del bucket, utilizza il comando
gcloud storage ls
:gcloud storage ls gs://BUCKET_NAME
Sostituisci BUCKET_NAME con il nome del tuo bucket.
Se l'immagine è stata caricata correttamente nel bucket,
kitten.png
viene restituito nell'output.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina le risorse completando i seguenti passaggi:
Smonta il bucket di archiviazione dalla macchina Linux utilizzando lo strumento
fusermount
:fusermount -u "$HOME/mount-folder"
Per eliminare il bucket e tutto il suo contenuto, utilizza il comando
gcloud storage rm
con il flag--recursive
:gcloud storage rm gs://BUCKET_NAME --recursive
Sostituisci BUCKET_NAME con il nome del tuo bucket.
Se l'esito è positivo, il comando restituisce un output simile al seguente:
Removing gs://my-bucket/kitten.png#1676488739323620... Removing gs://my-bucket/...
Passaggi successivi
- Leggi una panoramica dettagliata di Cloud Storage FUSE.
- Scopri come Vertex AI utilizza Cloud Storage FUSE per montare i bucket Cloud Storage per i job di addestramento personalizzato.