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 Python 3 d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

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.

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

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

Important : La commande pip télécharge et installe la distribution PyPi de la bibliothèque cliente Cloud Storage. Cette distribution n'inclut pas le code de démonstration ou de test. Pour obtenir ces fichiers, clonez ou téléchargez le dépôt GitHub de la bibliothèque.

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

• Consultez la documentation de référence de 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.