Vous ne payez que pour les ressources que vous utilisez dans Cloud Storage. Ce guide de démarrage rapide utilise généralement moins de 0,01 USD de ressources Cloud Storage.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
Dans Google Cloud Console, sur la page de sélection du projet, cliquez sur Créer un projet pour commencer à créer un projet Google Cloud.
-
Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.
- Installez le SDK Cloud.
Lorsque vous y êtes invité, choisissez le projet que vous avez créé ci-dessus.
- Installez Python 3.8.
Si vous utilisez Windows et que vous avez laissé la case correspondante cochée lors de l'installation du SDK Cloud, cette opération a été effectuée automatiquement.
Créer un bucket
Les buckets sont les conteneurs de base dans lesquels sont stockées vos données dans Cloud Storage.
Pour créer un bucket :
- Ouvrez une fenêtre de terminal.
Exécutez la commande
gsutil mb
et utilisez un nom unique pour créer un bucket :gsutil mb -b on -l us-east1 gs://my-awesome-bucket/
Cette commande utilise un bucket nommé "my-awesome-bucket". Vous devez choisir un nom unique pour votre bucket.
Si l'opération réussit, la commande renvoie le résultat suivant :
Creating gs://my-awesome-bucket/...
Vous venez de créer un bucket dans lequel vous pouvez stocker vos données.
Creating gs://my-awesome-bucket/... ServiceException: 409 Bucket my-awesome-bucket already exists.
Réessayez en donnant un autre nom au bucket.
Importer un objet dans un bucket
Cliquez avec le bouton droit sur l'image ci-dessus et enregistrez-la sur votre ordinateur, par exemple sur le bureau.
Exécutez la commande
gsutil cp
pour copier l'image à partir de l'emplacement où vous l'avez enregistrée dans le bucket que vous avez créé :gsutil cp Desktop/kitten.png gs://my-awesome-bucket
Si l'opération réussit, la commande renvoie le résultat suivant :
Copying file://Desktop/kitten.png [Content-Type=image/png]... Uploading gs://my-awesome-bucket/kitten.png: 0 B/164.3 KiB Uploading gs://my-awesome-bucket/kitten.png: 164.3 KiB/164.3 KiB
Vous venez de stocker un objet dans votre bucket.
Télécharger l'objet à partir du bucket
Exécutez la commande
gsutil cp
pour télécharger l'image que vous avez stockée dans votre bucket sur votre ordinateur, par exemple sur le bureau :gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png
Si l'opération réussit, la commande renvoie le résultat suivant :
Copying gs://my-awesome-bucket/kitten.png... Downloading file://Desktop/kitten2.png: 0 B/164.3 KiB Downloading file://Desktop/kitten2.png: 164.3 KiB/164.3 KiB
Vous venez de télécharger un objet à partir de votre bucket.
Copier l'objet dans un dossier du bucket
Utilisez la commande
gsutil cp
pour créer un dossier et y copier l'image :gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
Si l'opération réussit, la commande renvoie le résultat suivant :
Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]... Copying ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB
Vous venez de copier votre image dans un nouveau dossier de votre bucket.
Afficher le contenu d'un bucket ou d'un dossier
Utilisez la commande
gsutil ls
pour répertorier le contenu du niveau supérieur de votre bucket :gsutil ls gs://my-awesome-bucket
Si l'opération réussit, la commande renvoie un message semblable à celui indiqué ci-dessous :
gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/
Vous venez d'afficher le contenu du niveau supérieur de votre bucket.
Afficher les détails d'un objet
Exécutez la commande
gsutil ls
avec l'option-l
pour obtenir des détails sur l'une de vos images :gsutil ls -l gs://my-awesome-bucket/kitten.png
Si l'opération réussit, la commande renvoie un message semblable à celui indiqué ci-dessous :
2638 2016-02-26T23:05:14Z gs://my-awesome-bucket/kitten.png TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
Vous venez d'obtenir des informations sur la taille et la date de création de l'image.
Rendre les objets accessibles au public
Exécutez la commande
gsutil iam ch
pour autoriser tous les utilisateurs à lire les images stockées dans votre bucket :gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket
La commande aboutit si aucune erreur n'est affichée.
Désormais, tout le monde peut obtenir vos images.
Pour supprimer cet accès, exécutez la commande suivante :
gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket
La commande aboutit si aucune erreur n'est affichée.
Vous avez supprimé l'accès public aux images de votre bucket.
Autoriser l'accès au bucket
Utilisez la commande
gsutil iam ch
pour autoriser une adresse e-mail spécifique à accéder aux objets de votre bucket en lecture et écriture :gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket
La commande aboutit si aucune erreur n'est affichée.
Un autre utilisateur peut maintenant ajouter des éléments à votre bucket ou afficher son contenu.
Pour supprimer cette autorisation, exécutez la commande suivante :
gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket
La commande aboutit si aucune erreur n'est affichée.
Vous venez de supprimer l'accès de l'utilisateur à ce bucket.
Supprimer un objet
Exécutez la commande
gsutil rm
pour supprimer l'une de vos images :gsutil rm gs://my-awesome-bucket/kitten.png
Si l'opération réussit, la commande renvoie le résultat suivant :
Removing gs://my-awesome-bucket/kitten.png...
Cette copie de l'image n'est plus stockée dans Cloud Storage (mais la copie que vous en avez faite dans le dossier
just-a-folder/
existe encore).
Nettoyer
Afin d'éviter que des frais ne soient facturés sur votre compte Google Cloud pour les ressources utilisées dans ce guide de démarrage rapide, procédez comme suit :
- Ouvrez une fenêtre de terminal (si aucune n'est déjà ouverte).
Utilisez la commande
rm command
avec l'indicateur-r
pour supprimer le répertoire contenant votre tâche la plus récente :gsutil rm -r gs://my-awesome-bucket
Si l'opération réussit, la commande renvoie un message semblable à celui indiqué ci-dessous :
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000... Removing gs://my-awesome-bucket/...
Vous venez de supprimer votre bucket et son contenu.
Étape suivante
- Suivez le guide de démarrage rapide Cloud Storage sur l'utilisation de Google Cloud Console.
- Consultez les guides disponibles pour effectuer des tâches dans Cloud Storage.
- Découvrez les termes clés de Cloud Storage.
- Découvrez la grille tarifaire de Cloud Storage.
- Consultez les pages de référence sur les commandes gsutil, telles que créer un bucket (
mb
), copier (cp
), répertorier (ls
), gestion des identités (iam
) et supprimer (rm
).