Monta un bucket Cloud Storage utilizzando Cloud Storage FUSE

Scopri come montare un bucket Cloud Storage come file system locale utilizzando Cloud Storage FUSE, per consentirti di interagire con gli oggetti utilizzando un file standard la semantica del sistema.

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 Google Cloud CLI per creare e gestire l'oggetto nel bucket di archiviazione e utilizzerai gcsfuse CLI per montare il bucket sulla tua macchina.

Prima di iniziare

Per configurare un progetto, completa i seguenti passaggi:

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. To initialize the gcloud CLI, run the following command: 

    gcloud init

  6. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init
  10. Avere un bucket Cloud Storage da montare. In caso contrario ne hai già uno, creane uno nuovo del bucket.

Installa Cloud Storage FUSE

Per installare Cloud Storage FUSE, completa le seguenti istruzioni utilizzando il tuo shell locale su Debian o Ubuntu:

  1. 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

  2. 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 -

  3. Aggiorna l'elenco dei pacchetti disponibili:

    sudo apt-get update

  4. Installa Cloud Storage FUSE e la relativa dipendenza FUSE:

    sudo apt-get install fuse gcsfuse

  5. Quando richiesto, premi Invio per confermare.

  6. Verifica che Cloud Storage FUSE sia stato installato:

    gcsfuse -v

    In caso di 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 nel file system locale, completa questi passaggi:

  1. Genera le credenziali predefinite dell'applicazione utilizzando il comando gcloud auth application-default login:

    gcloud auth application-default login

    Cloud Storage FUSE carica automaticamente le credenziali.

  2. Crea una directory su cui montare il bucket di archiviazione:

    mkdir "$HOME/mount-folder"

  3. Monta il bucket di archiviazione utilizzando il comando gcsfuse:

    gcsfuse BUCKET_NAME "$HOME/mount-folder"

    Sostituisci BUCKET_NAME con il nome del bucket da 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 la seguenti passaggi:

Immagine di un gattino da caricare nel bucket.

  1. Fai clic con il pulsante destro del mouse sull'immagine riportata sopra e salvala sul computer ad esempio su computer.

    Puoi anche scaricare l'immagine utilizzando il comando cURL curl -O https://cloud.google.com/storage/images/kitten.png.

  2. Copia l'immagine dalla posizione salvata alla cartella in cui si trova il bucket montato, utilizzando il comando cp:

    cp kitten.png "$HOME/mount-folder/kitten.png"

  3. Verifica che l'immagine sia stata copiata nel file system locale e caricata correttamente nel separato seguendo i passaggi riportati di seguito:

    1. Per verificare che kitten.png sia stato copiato nel file system locale, esegui ls sulla cartella in cui è montato il bucket:

      ls "$HOME/mount-folder"

      Se l'operazione di copia è riuscita, il valore kitten.png viene restituito nel come output.

    2. Per elencare i contenuti del bucket, utilizza 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 è 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:

  1. Smonta il bucket di archiviazione dalla macchina Linux utilizzando l'fusermount questo strumento:

    fusermount -u "$HOME/mount-folder"

  2. Per eliminare il bucket e i contenuti al suo interno, utilizza la classe Comando gcloud storage rm con il flag --recursive:

    gcloud storage rm gs://BUCKET_NAME --recursive

    Sostituisci BUCKET_NAME con il nome del tuo bucket.

    In caso di esito positivo, il comando restituisce un output simile al seguente:

    Removing gs://my-bucket/kitten.png#1676488739323620...
 Removing gs://my-bucket/...

Passaggi successivi