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

Créez un projet Google Cloud et comprenez la structure des applications Python 2 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.

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

Vous pouvez télécharger la bibliothèque cliente App Engine pour Cloud Storage à l'aide d'outils populaires tels que pipou Git. Vous pouvez également télécharger la bibliothèque manuellement à partir de GitHub. Choisissez la méthode appropriée :

Git

Si Git est installé, vous pouvez cloner le dépôt GitHub de la bibliothèque cliente Cloud Storage d'App Engine comme suit :

git clone https://github.com/googleapis/python-storage.git

pip

Vous pouvez utiliser pip pour installer la bibliothèque cliente Cloud Storage comme suit :

pip install google-cloud-storage

Téléchargement manuel

Vous pouvez télécharger un fichier ZIP contenant la bibliothèque cliente App Engine pour Cloud Storage à partir de GitHub :

Bibliothèque cliente App Engine pour Cloud Storage sur GitHub

Installez la bibliothèque dans le répertoire que vous utilisez pour les bibliothèques tierces, comme par exemple lib. Pour plus d'informations, consultez Utiliser des bibliothèques tierces.

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.

Étapes suivantes