Vous pouvez utiliser Cloud Storage pour stocker et diffuser des fichiers, tels que des films, des images ou d'autres contenus statiques.
Ce document explique comment utiliser les bibliothèques clientes Cloud pour Cloud Storage dans votre application afin de stocker et de récupérer des données à partir de Cloud Storage.
Avant de commencer
- Suivez les instructions de la section Configurer votre environnement de développement pour configurer votre environnement et votre projet, et pour comprendre la structure des applications dans App Engine. Notez et enregistrez l'ID de votre projet. Vous en aurez besoin pour exécuter l'exemple d'application décrit dans ce document.
Veillez à créer un bucket Cloud Storage pour votre application en appelant la commande suivante :
gcloud storage buckets create gs://YOUR_BUCKET_NAME
Rendez le bucket lisible publiquement afin qu'il puisse diffuser des fichiers :
gcloud storage buckets add-iam-policy-binding gs://<var>YOUR_BUCKET_NAME</var> --member=allUsers --role=roles/storage.objectViewer
Télécharger l'exemple
Go
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/storage
Java
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-17/cloudstorage
Node.js
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible
PHP
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/storage
Python
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/storage
Ruby
Pour cloner le dépôt, exécutez :
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/storage/
.NET
Téléchargez l'exemple d'application et extrayez-le.
Si vous utilisez la ligne de commande, accédez au répertoire de l'application suivant :
dotnet-docs-samples\appengine\flexible\CloudStorage\CloudStorage.Sample
Pour exécuter votre application localement, configurez un compte de service et téléchargez les identifiants :
Ouvrez la liste des identifiants dans la console Google Cloud.
Cliquez sur Créer des identifiants.
Sélectionnez la clé de compte de service.
Une fenêtre Créer une clé de compte de service s'ouvre.
Cliquez sur la liste Compte de service, puis sélectionnez Compte de service Compute Engine par défaut.
Sélectionnez JSON pour le type de clé.
Cliquez sur Créer.
Une fenêtre Nouvelle clé privée s'affiche, et la clé privée est automatiquement téléchargée.
Cliquez sur Fermer.
.
Modifier la configuration du projet et installer les dépendances
Go
Dans app.yaml
, définissez GCLOUD_STORAGE_BUCKET
. Cette valeur correspond au nom du bucket Cloud Storage que vous avez créé précédemment.
Java
Dans le fichier app.yaml
, définissez BUCKET_NAME
sur le bucket Cloud Storage que vous avez précédemment créé pour votre projet.
Dans le fichier pom.xml
, définissez com.google.cloud
en tant que dépendance et spécifiez google-cloud-storage
comme ID d'artefact de cette dépendance. Cette action fournit les fonctions permettant d'utiliser Cloud Storage.
Node.js
Dans app.yaml
, ajoutez votre ID de projet à la valeur de l'environnement GOOGLE_CLOUD_PROJECT
. Définissez ensuite la valeur de l'environnement GCLOUD_STORAGE_BUCKET
sur le nom du bucket Cloud Storage que vous avez créé précédemment.
Dans le fichier package.json
, ajoutez @google-cloud/storage
en tant que dépendance, ce qui fournit les fonctions permettant d'utiliser Cloud Storage.
Consultez le fichier README.md
pour obtenir des instructions sur l'exécution et le test en local.
PHP
Dans app.yaml
, définissez CLOUD_STORAGE_BUCKET
. Cette valeur correspond au nom du bucket Cloud Storage que vous avez créé précédemment.
La bibliothèque cliente Cloud doit être incluse dans le fichier composer.json
. Cette bibliothèque est requise car elle fournit des fonctions Cloud Storage.
Python
Dans app.yaml
, définissez GOOGLE_STORAGE_BUCKET
. Cette valeur correspond au nom du bucket Cloud Storage que vous avez créé précédemment.
Notez que la bibliothèque google-cloud-storage
doit être incluse dans le fichier requirements.txt
, car elle fournit certaines fonctions Cloud Storage.
Ruby
Dans le fichier app.yaml
, définissez GCLOUD_STORAGE_BUCKET
sur le bucket Cloud Storage que vous avez précédemment créé pour votre projet.
Notez que vous devez inclure la bibliothèque gcloud
dans le fichier Gemfile
pour utiliser les fonctions Cloud Storage.
.NET
Dans le fichier app.yaml
, définissez TEST_GOOGLE_BUCKET_NAME
sur le bucket Cloud Storage que vous avez précédemment créé pour votre projet.
env_variables:
TEST_GOOGLE_BUCKET_NAME: [your-bucket-name]
Code d'application
Go
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Dès que l'utilisateur sélectionne un fichier et clique dessus pour l'envoyer, le gestionnaire d'importation écrit le fichier dans le bucket Cloud Storage à l'aide de la fonction NewWriter de Cloud Storage.
Notez que pour récupérer ce fichier depuis Cloud Storage, vous devez spécifier le nom du bucket et le nom du fichier. Vous devez stocker ces valeurs dans votre application pour une utilisation ultérieure.
Java
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire de requêtes doPost
écrit le fichier dans le bucket Cloud Storage à l'aide de Storage.create.
Notez que pour récupérer ce fichier depuis Cloud Storage, vous devez spécifier le nom du bucket et le nom du fichier. Vous devez stocker ces valeurs dans votre application pour une utilisation ultérieure.
Node.js
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire d'importation charge le contenu du fichier dans un blob et l'écrit dans Cloud Storage.
Notez qu'après le transfert du fichier dans Cloud Storage, l'URL publique de ce fichier est renvoyée. Vous pouvez l'utiliser pour diffuser le fichier directement à partir de Cloud Storage. Vous devez stocker cette valeur dans votre application pour une utilisation ultérieure.
PHP
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire d'importation charge le contenu du fichier dans un blob et l'écrit dans Cloud Storage.
Notez qu'après le transfert du fichier dans Cloud Storage, l'URL publique de ce fichier est renvoyée. Vous pouvez l'utiliser pour diffuser le fichier directement à partir de Cloud Storage. Vous devez stocker cette valeur dans votre application pour une utilisation ultérieure.
Python
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire d'importation charge le contenu du fichier dans un blob Cloud Storage et écrit le fichier dans le bucket Cloud Storage.
Notez qu'après l'importation du fichier dans Cloud Storage, l'URL publique de ce fichier vous est renvoyée. Vous pouvez l'utiliser pour diffuser le fichier directement à partir de Cloud Storage. Vous devez stocker cette valeur dans votre application pour une utilisation ultérieure.
Ruby
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire d'importation charge le contenu du fichier dans un blob et l'écrit dans Cloud Storage.
Notez qu'après le transfert du fichier dans Cloud Storage, l'URL publique de ce fichier est renvoyée. Vous pouvez l'utiliser pour diffuser le fichier directement à partir de Cloud Storage. Vous devez stocker cette valeur dans votre application pour une utilisation ultérieure.
.NET
L'exemple d'application présente une page Web invitant l'utilisateur à indiquer un fichier à stocker dans Cloud Storage. Lorsque l'utilisateur sélectionne un fichier et clique sur "Envoyer", le gestionnaire d'importation charge le contenu du fichier dans un blob et l'écrit dans Cloud Storage.
Notez qu'après le transfert du fichier dans Cloud Storage, l'URL publique de ce fichier est renvoyée. Vous pouvez l'utiliser pour diffuser le fichier directement à partir de Cloud Storage. Vous devez stocker cette valeur dans votre application pour une utilisation ultérieure.
Pour en savoir plus
Pour obtenir des informations complètes sur Cloud Storage, consultez la documentation Cloud Storage.