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.

Cette API est compatible avec les environnements d'exécution de première génération et peut être utilisée lors de la mise à niveau vers des environnements d'exécution de deuxième génération correspondants. Si vous effectuez une mise à jour vers l'environnement d'exécution Go 1.12+ d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

Configurer votre projet

Créez un projet Google Cloud et comprenez 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 activer et utiliser un autre bucket Cloud Storage. Le bucket par défaut inclut gratuitement les cinq premiers Go 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.

Remarque : Lorsque vous créez un bucket par défaut, vous obtenez également un bucket de préproduction portant le même nom, à ceci près qu'il comporte un préfixe staging.. Vous pouvez vous servir de ce bucket de préproduction pour les fichiers temporaires employés à des fins de préproduction et de test. Il est également limité à 5 Go, mais il est automatiquement vidé toutes les semaines.

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 bucket de stockage et à son contenu, consultez Définir les autorisations des buckets 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 utilisez Linux et macOS, vous pouvez configurer GOPATH comme suit :

   mkdir -p $HOME/go
   export GOPATH=$HOME/go

   Remarque : Pour obtenir des instructions pour Windows, consultez la section Windows de la page Getting Started with the Go Programming Language (Premiers pas avec le langage de programmation 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/...

   Remarque : Ces packages seront téléchargés dans le répertoire src de GOPATH.

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.

Sachez que Cloud Storage est un service payant qui vous sera facturé selon 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

• Consultez la documentation de référence sur l'API.
• Découvrez comment lire et écrire dans Google Cloud Storage à l'aide de la bibliothèque cliente App Engine pour Cloud Storage.
• Consultez l'exemple App Engine et Google Cloud Storage.
• Consultez l'intégralité de la documentation Cloud Storage, y compris des tutoriels et des exemples supplémentaires.