Configurer Google Cloud Storage

Vous pouvez vous servir d'un bucket Cloud Storage pour stocker et diffuser des fichiers, tels que des films, des images ou d'autres contenus statiques. Ce document explique comment configurer votre environnement pour utiliser la bibliothèque cliente Cloud Storage d'App Engine.

Configurer le projet

Suivez les instructions de la page Créer une application Guestbook pour configurer votre environnement, créer un projet Cloud et comprendre la structure des applications Go 1.11 dans App Engine. Notez et enregistrez l'ID du projet pour l'utiliser avec votre application.

Activer un bucket Cloud Storage

Pour employer Cloud Storage, vous devez activer au moins un bucket. Vous voudrez peut-être utiliser le bucket par défaut, qui fournit gratuitement les 5 premiers Go d'espace de stockage. Vous pouvez toujours activer et utiliser un autre bucket Cloud Storage si vous le souhaitez, mais seul celui par défaut propose gratuitement les 5 premiers Go d'espace de stockage. Le bucket par défaut inclut également un quota gratuit pour les opérations d'E/S Cloud Storage. Pour en savoir plus, consultez la section Tarifs, quotas et limites.

Pour activer le bucket Cloud Storage par défaut pour votre application :

  1. Cliquez sur Créer sous Bucket Cloud Storage par défaut sur la page Paramètres d'App Engine du projet. Notez le nom de ce bucket : il se présente sous la forme <project-id>.appspot.com.

  2. Si vous avez besoin d'un espace de stockage supérieur à la limite des 5 Go, vous pouvez l'augmenter en activant la facturation du projet, ce qui en fait un bucket payant. L'espace de stockage au-delà de la limite des 5 Go vous sera facturé.

Si vous souhaitez activer un ou plusieurs buckets payants, suivez les instructions figurant sous la section Créer un bucket.

Définir des autorisations relatives au bucket et aux objets

Pour savoir comment autoriser le compte de service de votre application ou d'autres utilisateurs à accéder au compartiment de stockage et à son contenu, consultez les pages Définir les autorisations des ensembles et Définir les autorisations des objets.

Télécharger la bibliothèque cliente

La bibliothèque cliente App Engine pour Cloud Storage est disponible via l'outil go. Pour télécharger la bibliothèque :

  1. Configurez la variable d'environnement GOPATH si nécessaire. Si vous employez Linux et macOS, vous pouvez configurer GOPATH comme suit :

    mkdir -p $HOME/go
    export GOPATH=$HOME/go
  2. Téléchargez les packages oauth2, storage et appengine :

    go get -u golang.org/x/oauth2
    go get -u cloud.google.com/go/storage
    go get -u google.golang.org/appengine/...
Pour en savoir plus sur l'installation de la bibliothèque cliente, consultez la page Bibliothèques clientes Cloud Storage.

Utiliser la bibliothèque cliente avec le serveur d'applications de développement

Vous pouvez employer la bibliothèque cliente avec le serveur de développement. Cependant, en l'absence d'émulation locale de Cloud Storage, toutes les requêtes de lecture et d'écriture de fichiers doivent être envoyées par Internet à un bucket Cloud Storage réel.

Pour employer la bibliothèque cliente avec le serveur d'applications de développement :

  1. Activez un bucket Cloud Storage.

  2. Exécutez dev_appserver.py avec l'option --default_gcs_bucket_name [BUCKET_NAME], en remplaçant [BUCKET_NAME] par le nom du bucket Cloud Storage que vous utilisez.

    Cette option contrôle le bucket qui est renvoyé lorsque l'application appelle file.DefaultBucketName(ctx).

Tarifs, quotas et limites

Aucuns frais d'utilisation de la bande passante ne sont associés aux appels vers Cloud Storage depuis la bibliothèque cliente d'App Engine. Cependant, des frais d'opération s'appliquent. En outre, les appels sont comptabilisés dans votre quota de récupération d'URL, car la bibliothèque interagit avec Cloud Storage à l'aide du service de récupération d'URL.

Notez que Google Cloud Storage est un service payant. La facturation est établie conformément à la grille tarifaire de Cloud Storage.

Autres moyens d'accéder à Cloud Storage

À la place de la bibliothèque cliente, vous pouvez employer :

  • Le Navigateur Cloud Storage de Google Cloud Console, qui permet d'importer rapidement des objets.
  • gsutil, un outil de ligne de commande permettant d'exploiter des fichiers dans Cloud Storage.

Étape suivante