Aprende a activar un bucket de Cloud Storage como un sistema de archivos local mediante Cloud Storage FUSE para que puedas interactuar con los objetos mediante 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 gcsfuse para activar tu bucket en tu máquina.
Antes de comenzar
Para configurar un proyecto, completa los siguientes pasos:
- 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.
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- 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, completa las siguientes instrucciones con tu shell local en Debian o Ubuntu:
Agrega la URL de distribución de Cloud Storage FUSE como fuente de paquetes:
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 clave pública del repositorio de APT de Google Cloud:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Actualiza la lista de paquetes disponibles:
sudo apt-get update
Instala Cloud Storage FUSE y su dependencia de FUSE:
sudo apt-get install fuse gcsfuse
Cuando se te solicite, presiona Intro para confirmar.
Confirma que Cloud Storage FUSE se haya instalado:
gcsfuse -v
Si se completa correctamente, el comando muestra un resultado similar al siguiente:
gcsfuse version 0.41.12 (Go version go1.18.4)
Activa el bucket
Para activar el bucket en tu sistema de archivos local, completa los siguientes pasos:
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.
Crea un directorio para activar el bucket de almacenamiento:
mkdir "$HOME/mount-folder"
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:
Haz clic derecho sobre la imagen anterior 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
.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"
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:
Para verificar que
kitten.png
se haya copiado en tu sistema de archivos local, ejecutals
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.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.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra los recursos mediante los siguientes pasos:
Desactiva el bucket de almacenamiento desde tu máquina Linux con la herramienta
fusermount
:fusermount -u "$HOME/mount-folder"
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?
- Descubre cómo Vertex AI usa Cloud Storage FUSE a fin de activar buckets de Cloud Storage para trabajos de entrenamiento personalizados.