Activa un bucket de Cloud Storage con Cloud Storage FUSE

Aprende a activar un bucket de Cloud Storage como un sistema de archivos local con Cloud Storage FUSE para que puedas interactuar con tus objetos usando la semántica del sistema de archivos estándar.

En este instructivo, completarás las siguientes tareas:

  • Instalar Cloud Storage FUSE en Debian o Ubuntu

  • Activar el bucket como una carpeta en la máquina

  • Subir un objeto al bucket

Usarás Google Cloud CLI para crear y administrar el objeto en tu bucket de almacenamiento, y usarás la CLI de Cloud Storage FUSE para activar tu bucket en tu máquina.

Antes de comenzar

Para configurar un proyecto, completa los siguientes pasos:

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  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. Instala Google Cloud CLI.

  6. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  7. Para inicializar gcloud CLI, ejecuta el siguiente 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. Instala Google Cloud CLI.

  12. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  13. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init
  14. Debes tener un bucket de Cloud Storage que desees activar. Si todavía no tienes uno, crea un bucket nuevo.

Instala Cloud Storage FUSE

Para instalar Cloud Storage FUSE, sigue las instrucciones que se indican en Instala Cloud Storage FUSE.

Activa el bucket

Para activar el bucket en tu sistema de archivos local, completa los siguientes pasos:

  1. Genera las credenciales predeterminadas de la aplicación con el comando gcloud auth application-default login:

    gcloud auth application-default login

    Cloud Storage FUSE carga de forma automática las credenciales.

  2. Crea un directorio para activar el bucket de almacenamiento:

    mkdir "$HOME/mount-folder"

  3. Activa el depósito de almacenamiento con el comando gcsfuse:

    gcsfuse BUCKET_NAME "$HOME/mount-folder"

    Reemplaza BUCKET_NAME por el nombre del bucket que desees activar.

    Si se completa correctamente, el comando muestra un resultado que contiene un texto similar al siguiente:

    File system has been successfully mounted.

Sube un objeto al bucket

Para descargar un objeto de ejemplo y subirlo al bucket activado, completa los siguientes pasos:

La imagen de un gatito que se subirá al bucket

  1. Haz clic con el botón derecho en la imagen y guárdala en algún lugar de tu computadora, como el escritorio.

    También puedes descargar la imagen con el comando cURL curl -O https://cloud.google.com/storage/images/kitten.png.

  2. Copia la imagen de su ubicación guardada en la carpeta en la que está activado el bucket con el comando cp:

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

  3. Para verificar que la imagen se haya copiado a tu sistema de archivos local y que se haya subido al bucket de manera correcta, sigue los pasos a continuación:

    1. Para verificar que kitten.png se haya copiado en tu sistema de archivos local, ejecuta ls en la carpeta en la que está activado tu bucket:

      ls "$HOME/mount-folder"

      Si la operación de copia se realizó de forma correcta, se muestra kitten.png en el resultado.

    2. Para enumerar el contenido de tu bucket, usa el comando gcloud storage ls:

      gcloud storage ls gs://BUCKET_NAME

      Reemplaza BUCKET_NAME con el nombre de tu bucket:

      Si la imagen se subió de forma correcta a tu bucket, se muestra kitten.png en el resultado.

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra los recursos siguiendo estos pasos:

  1. Desactiva el bucket de almacenamiento desde tu máquina Linux con la herramienta fusermount:

    fusermount -u "$HOME/mount-folder"

  2. Para borrar el bucket y su contenido, usa el comando gcloud storage rm con la marca --recursive:

    gcloud storage rm gs://BUCKET_NAME --recursive

    Reemplaza BUCKET_NAME con el nombre de tu bucket:

    Si se completa correctamente, el comando muestra un resultado similar al siguiente:

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

¿Qué sigue?