Montare un bucket Cloud Storage utilizzando Cloud Storage FUSE

Scopri come montare un bucket Cloud Storage come file system locale utilizzando Cloud Storage FUSE, in modo da poter interagire con gli oggetti utilizzando la semantica standard del file system.

In questa guida rapida completerai le seguenti attività:

  • Installare Cloud Storage FUSE su Debian o Ubuntu

  • Montare il bucket come cartella sul computer

  • Caricare un oggetto nel bucket

Utilizzerai Google Cloud CLI per creare e gestire l'oggetto nel bucket di archiviazione e utilizzerai Cloud Storage FUSE CLI per montare il bucket sul computer.

Prima di iniziare

Per configurare un progetto, completa i seguenti passaggi:

  1. Accedi al tuo Google Cloud account. 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 senza costi per l'esecuzione, il test e il deployment dei workload.

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

    Roles required to create a project

    To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Storage Admin (roles/storage.admin), Storage Bucket Viewer (roles/storage.bucketViewer)

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

  5. Installa Google Cloud CLI.

  6. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  7. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

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

    Roles required to create a project

    To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. Make sure that you have the following role or roles on the project: Storage Admin (roles/storage.admin), Storage Bucket Viewer (roles/storage.bucketViewer)

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

  11. Installa Google Cloud CLI.

  12. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  13. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init
  14. Avere un bucket Cloud Storage che vuoi montare. Se non ne hai già uno, crea un nuovo bucket.

Installare Cloud Storage FUSE

Per installare Cloud Storage FUSE, segui le istruzioni riportate in Installare Cloud Storage FUSE.

Montare il bucket

Per montare il bucket sul file system locale, completa i seguenti 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 in 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 che vuoi montare.

    Se l'operazione va a buon fine, il comando restituisce un output contenente testo simile al seguente:

    File system has been successfully mounted.

Caricare un oggetto nel bucket

Per scaricare un oggetto di esempio e caricarlo nel bucket montato, completa i seguenti passaggi:

Immagine di un gattino da caricare nel bucket.

  1. Fai clic con il tasto destro del mouse sull'immagine e salvala in un punto qualsiasi del computer, ad esempio sul desktop.

    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 in cui è stata salvata nella cartella in cui è montato il bucket 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 bucket seguendo questi passaggi:

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

      ls "$HOME/mount-folder"

      Se l'operazione di copia è andata a buon fine, kitten.png viene restituito nell'output.

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

      Se l'immagine è stata caricata correttamente nel bucket, kitten.png viene restituito nell'output.

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina le risorse completando i seguenti passaggi:

  1. Smonta il bucket di archiviazione dal computer Linux utilizzando lo strumento fusermount:

    fusermount -u "$HOME/mount-folder"

  2. Per eliminare il bucket e tutto ciò che contiene, utilizza il comando gcloud storage rm con il flag --recursive:

    gcloud storage rm gs://BUCKET_NAME --recursive

    Sostituisci BUCKET_NAME con il nome del bucket.

    Se l'operazione va a buon fine, il comando restituisce un output simile al seguente:

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

Passaggi successivi