Découvrez comment installer un bucket Cloud Storage en tant que système de fichiers local à l'aide de Cloud Storage FUSE afin de pouvoir interagir avec vos objets avec une sémantique de système de fichiers standard.
Dans ce guide de démarrage rapide, vous allez effectuer les tâches suivantes :
Installer Cloud Storage FUSE sur Debian ou Ubuntu
Installer le bucket en tant que dossier sur la machine
Importer un objet dans le bucket
Vous allez utiliser Google Cloud CLI pour créer et gérer l'objet dans votre bucket de stockage. Vous utiliserez la CLI gcsfuse pour installer votre bucket sur votre ordinateur.
Avant de commencer
Pour configurer un projet, procédez comme suit:
- 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.
-
In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- 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.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Disposer d'un bucket Cloud Storage que vous souhaitez installer. Si vous n'en avez pas déjà un, créez un bucket.
Installer Cloud Storage FUSE
Pour installer Cloud Storage FUSE, procédez comme suit à l'aide de votre interface système locale sur Debian ou Ubuntu :
Ajoutez l'URL de distribution Cloud Storage FUSE en tant que source de package:
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
Importez la clé publique du dépôt Google Cloud APT :
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Mettez à jour la liste des packages disponibles :
sudo apt-get update
Installez Cloud Storage FUSE et sa dépendance FUSE :
sudo apt-get install fuse gcsfuse
Lorsque vous y êtes invité, appuyez sur Entrée pour confirmer.
Vérifiez que Cloud Storage FUSE a bien été installé :
gcsfuse -v
Si l'opération réussit, la commande renvoie un résultat semblable à celui-ci :
gcsfuse version 0.41.12 (Go version go1.18.4)
Installer le bucket
Pour installer le bucket sur votre système de fichiers local, procédez comme suit:
Générez les Identifiants par défaut de l'application à l'aide de la commande
gcloud auth application-default login
:gcloud auth application-default login
Cloud Storage FUSE charge automatiquement les identifiants.
Créez un répertoire dans lequel installer le bucket de stockage :
mkdir "$HOME/mount-folder"
Installez votre bucket de stockage à l'aide de la commande
gcsfuse
:gcsfuse BUCKET_NAME "$HOME/mount-folder"
Remplacez BUCKET_NAME par le nom du bucket que vous souhaitez installer.
Si l'opération réussit, la commande renvoie un résultat contenant du texte semblable à ce qui suit :
File system has been successfully mounted.
Importer un objet dans le bucket
Pour télécharger un exemple d'objet et l'importer dans le bucket installé, procédez comme suit :
Cliquez avec le bouton droit sur l'image ci-dessus et enregistrez-la sur votre ordinateur, par exemple sur le bureau.
Vous pouvez également télécharger l'image à l'aide de la commande cURL
curl -O https://cloud.google.com/storage/images/kitten.png
.Copiez l'image à partir de son emplacement enregistré dans le dossier où votre bucket est installé, à l'aide de la commande
cp
:cp kitten.png "$HOME/mount-folder/kitten.png"
Vérifiez que l'image a bien été copiée dans votre système de fichiers local et importée dans le bucket en procédant comme suit :
Pour vérifier que
kitten.png
a bien été copié sur votre système de fichiers local, exécutezls
dans le dossier dans lequel votre bucket est installé :ls "$HOME/mount-folder"
Si l'opération de copie a abouti, le code
kitten.png
est renvoyé dans le résultat.Pour répertorier le contenu de votre bucket, utilisez la commande
gcloud storage ls
:gcloud storage ls gs://BUCKET_NAME
Remplacez BUCKET_NAME par le nom de votre bucket :
Si l'image a bien été importée dans votre bucket,
kitten.png
est renvoyé dans la sortie.
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, supprimez-les en procédant comme suit :
Désinstallez le bucket de stockage de votre machine Linux à l'aide de l'outil
fusermount
:fusermount -u "$HOME/mount-folder"
Pour supprimer le bucket et tous les éléments qu'il contient, exécutez la commande
gcloud storage rm
avec l'option--recursive
:gcloud storage rm gs://BUCKET_NAME --recursive
Remplacez BUCKET_NAME par le nom de votre bucket :
Si l'opération réussit, la commande renvoie un résultat semblable à celui-ci :
Removing gs://my-bucket/kitten.png#1676488739323620... Removing gs://my-bucket/...
Étapes suivantes
- Obtenez une présentation détaillée de Cloud Storage FUSE.
- Découvrez comment Vertex AI utilise Cloud Storage FUSE pour installer des buckets Cloud Storage pour les jobs d'entraînement personnalisé.