Montar un segmento de Cloud Storage con Cloud Storage FUSE

Consulta cómo montar un segmento de Cloud Storage como sistema de archivos local mediante Cloud Storage FUSE para poder interactuar con tus objetos usando la semántica estándar del sistema de archivos.

En esta guía de inicio rápido, completarás las siguientes tareas:

  • Instalar Cloud Storage FUSE en Debian o Ubuntu

  • Montar el contenedor como una carpeta en la máquina

  • Subir un objeto al segmento

Usarás la CLI de Google Cloud para crear y gestionar el objeto en tu segmento de almacenamiento, y la CLI de gcsfuse para montar el segmento en tu máquina.

Antes de empezar

Para configurar un proyecto, sigue estos pasos:

  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.

    Roles required to create a project

    To create a project, you need the Project Creator (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.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

  5. Install the Google Cloud CLI.

  6. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud 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 (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.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

  11. Install the Google Cloud CLI.

  12. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

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

    gcloud init
  14. Tener un segmento de Cloud Storage que quieras montar. Si aún no tienes uno, crea un nuevo cubo.

    15. Instalar Cloud Storage FUSE

    Para instalar Cloud Storage FUSE, sigue las instrucciones de Instalar Cloud Storage FUSE.

    Montar el cubo

    Para montar el contenedor en tu sistema de archivos local, sigue estos pasos:

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

      gcloud auth application-default login

      Cloud Storage FUSE carga las credenciales automáticamente.

    2. Crea un directorio en el que montar el segmento de almacenamiento:

      mkdir "$HOME/mount-folder"

    3. Monta tu segmento de almacenamiento con el comando gcsfuse:

      gcsfuse BUCKET_NAME "$HOME/mount-folder"

      Sustituye BUCKET_NAME por el nombre del contenedor que quieras montar.

      Si la acción se realiza correctamente, el comando devuelve un resultado que contiene texto similar al siguiente:

      File system has been successfully mounted.

    Subir un objeto al segmento

    Para descargar un objeto de ejemplo y subirlo al contenedor montado, sigue estos pasos:

    La imagen de un gatito que se va a subir al contenedor.

    1. Haz clic con el botón derecho en la imagen y guárdala en algún lugar de tu ordenador, 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 desde su ubicación guardada en la carpeta donde está montado tu segmento, mediante el comando cp:

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

    3. Para comprobar que la imagen se ha copiado en tu sistema de archivos local y se ha subido al contenedor correctamente, sigue estos pasos:

      1. Para comprobar que kitten.png se ha copiado en tu sistema de archivos local, ejecuta ls en la carpeta en la que está montado tu contenedor:

        ls "$HOME/mount-folder"

        Si la operación de copia se ha realizado correctamente, se devuelve kitten.png en el resultado.

      2. Para ver el contenido de tu segmento, usa el comando gcloud storage ls:

        gcloud storage ls gs://BUCKET_NAME

        Sustituye BUCKET_NAME por el nombre de tu segmento.

        Si la imagen se ha subido correctamente al bucket, se devuelve kitten.png en el resultado.

    Limpieza

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

    1. Desmonta el contenedor de almacenamiento de tu máquina Linux con la herramienta fusermount:

      fusermount -u "$HOME/mount-folder"

    2. Para eliminar el segmento y todo su contenido, usa el comando gcloud storage rm con la marca --recursive:

      gcloud storage rm gs://BUCKET_NAME --recursive

      Sustituye BUCKET_NAME por el nombre de tu segmento.

      Si la acción se realiza correctamente, el comando devuelve un resultado similar al siguiente:

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

    Siguientes pasos