Un projet Firebase n'est en fait qu'un Google Cloud projet pour lequel des configurations et des services Firebase supplémentaires sont activés. Cela signifie que tous les Cloud Storage buckets que vous utilisez avec Cloud Storage for Firebase sont accessibles dans Google Cloud (y compris sa console et ses API).
Points à prendre compte sur les comptes de service
Firebase utilise des comptes de service Google Cloud pour exploiter et gérer les services
sans partager les identifiants des utilisateurs. Lorsque vous créez un projet Firebase qui utilise
Cloud Storage, vous remarquerez peut-être qu'un compte de service correspondant est
déjà disponible dans votre projet :
Google Cloud Storage
Vous pouvez utiliser les Google Cloud Storage API pour accéder aux fichiers importés via les Firebase SDK pour Cloud Storage, en particulier pour effectuer des opérations plus complexes, telles que copier ou déplacer un fichier, ou répertorier tous les fichiers disponibles dans une référence.
Il est important de noter que ces requêtes utilisent les Google Cloud Storage options de contrôle des accès, plutôt que Firebase Authentication et Cloud Storage Security Rules.
API
En plus des Firebase SDK pour Cloud Storage, vous pouvez accéder aux données stockées dans votre bucket Cloud Storage de différentes manières, selon ce que vous
souhaitez faire. Si vous accédez aux données sur un serveur, nous proposons des bibliothèques côté serveur, ainsi qu'une API RESTful JSON et XML compatible avec S3. Si vous
avez besoin de créer des scripts de modifications ou d'effectuer d'autres tâches administratives, nous disposons d'un
outil de ligne de commande qui vous sera utile.
SDK serveur Google Cloud
Google Cloud propose des SDK serveur de haute qualité pour un certain nombre de produits cloud, y compris Cloud Storage. Ces bibliothèques sont disponibles dans Node.js, Java, Go, Python, PHP, et Ruby.
Pour en savoir plus, y compris sur les instructions d'installation, l'authentification et le dépannage, consultez la documentation spécifique à la plate-forme liée ci-dessus.
Vous trouverez ci-dessous un exemple d'utilisation du Google Cloud Storage SDK :
Node.js
// Require gcloud var gcloud = require('google-cloud'); // Enable Cloud Storage var gcs = gcloud.storage({ projectId: 'grape-spaceship-123', keyFilename: '/path/to/keyfile.json' }); // Reference an existing bucket. var bucket = gcs.bucket('my-existing-bucket'); // Upload a local file to a new file to be created in your bucket. bucket.upload('/photos/zoo/zebra.jpg', function(err, file) { if (!err) { // "zebra.jpg" is now in your bucket. } }); // Download a file from your bucket. bucket.file('giraffe.jpg').download({ destination: '/photos/zoo/giraffe.jpg' }, function(err) {});
Java
// Enable Cloud Storage Storage storage = StorageOptions.builder() .authCredentials(AuthCredentials.createForJson(new FileInputStream("/path/to/my/key.json")) .build() .service(); // Upload a local file to a new file to be created in your bucket. InputStream uploadContent = ... BlobId blobId = BlobId.of("my-existing-bucket", "zebra.jpg"); BlobInfo blobInfo = BlobInfo.builder(blobId).contentType("text/plain").build(); Blob zebraBlob = storage.create(blobInfo, content); // Download a file from your bucket. Blob giraffeBlob = storage.get("my-existing-bucket", "giraffe.jpg", null); InputStream downloadContent = giraffeBlob.getInputStream();
Go
// Enable Cloud Storage client, err := storage.NewClient(ctx, option.WithServiceAccountFile("path/to/keyfile.json")) if err != nil { log.Fatal(err) } // Download a file from your bucket. rc, err := client.Bucket("my-existing-bucket").Object("giraffe.jpg").NewReader(ctx) if err != nil { log.Fatal(err) } defer rc.Close() body, err := ioutil.ReadAll(rc) if err != nil { log.Fatal(err) }
Python
# Import gcloud from google.cloud import storage # Enable Cloud Storage client = storage.Client() # Reference an existing bucket. bucket = client.get_bucket('my-existing-bucket') # Upload a local file to a new file to be created in your bucket. zebraBlob = bucket.get_blob('zebra.jpg') zebraBlob.upload_from_filename(filename='/photos/zoo/zebra.jpg') # Download a file from your bucket. giraffeBlob = bucket.get_blob('giraffe.jpg') giraffeBlob.download_as_string()
PHP
// Require gcloud require 'vendor/autoload.php'; use Google\Cloud\Storage\StorageClient; // Enable Cloud Storage $storage = new StorageClient([ 'projectId' => 'grape-spaceship-123' ]); // Reference an existing bucket. $bucket = $storage->bucket('my-existing-bucket'); // Upload a file to the bucket. $bucket->upload( fopen('/photos/zoo/zebra.jpg', 'r') ); // Download a file from your bucket. $object = $bucket->object('giraffe.jpg'); $object->downloadToFile('/photos/zoo/giraffe.jpg');
Ruby
# Require gcloud require "google/cloud" # Enable Cloud Storage gcloud = Google::Cloud.new "grape-spaceship-123", "/path/to/keyfile.json" storage = gcloud.storage # Reference an existing bucket. bucket = storage.bucket "my-existing-bucket" # Upload a file to the bucket. bucket.create_file "/photos/zoo/zebra.jpg", "zebra.jpg" # Download a file from your bucket. file = bucket.file "giraffe.jpg" file.download "/photos/zoo/#{file.name}"
API REST
Si vous utilisez un langage sans bibliothèque cliente, que vous souhaitez effectuer une action que les bibliothèques clientes ne permettent pas ou que vous avez simplement un client HTTP préféré que vous souhaitez utiliser, Google Cloud Storage propose des API pour les formatsJSON et XML.
En plus de ces API d'accès aux données de stockage, vous pouvez utiliser l'API Cloud Storage pour Firebase afin de gérer les buckets Cloud Storage à utiliser dans les projets Firebase.
gsutil
gsutil est un outil de ligne
de commande qui vous donne un accès direct à Cloud Storage. Vous pouvez l'utiliser gsutil
pour un large panel de tâches de gestion des buckets et des objets, y compris pour :
- importer, télécharger et supprimer des objets ;
- répertorier des buckets et des objets ;
- déplacer, copier et renommer des objets ;
- modifier les listes de contrôle d'accès (LCA) des objets et des buckets.
gsutil permet d'effectuer d'autres opérations avancées, telles que déplacer des fichiers d'un répertoire à un autre ou supprimer tous les fichiers situés sous un certain emplacement.
Déplacer tous les fichiers d'une référence à une autre est aussi simple que :
gsutil mv gs://bucket/old/reference gs://bucket/new/reference
La suppression par lot de tous les fichiers situés sous une référence est tout aussi intuitive :
# Delete all files under a path gsutil rm -r gs://bucket/reference/to/delete# Delete all the files in a bucket but not the bucket gsutil rm -r gs://bucket/**
# Delete all the files AND the bucket # Removing the default bucket will break the Firebase SDKs for Cloud Storage and is strongly discouraged gsutil rm -r gs://bucket
Taux de requêtes
Google Cloud Storage est un service ultra évolutif qui exploite la technologie d'autoscaling pour atteindre des taux de demandes très élevés.
Google Cloud Storage est un service mutualisé, ce qui signifie que les utilisateurs partagent le même ensemble de ressources sous-jacentes. Afin d'optimiser l'utilisation de ces ressources partagées, les buckets ont une capacité d'E/S initiale.
Lorsque vous prévoyez d'intégrer Cloud Storage for Firebase à votre application, réfléchissez au taux de requêtes minimal dont votre application a besoin pour de bonnes performances et à la manière d'effectuer des requêtes de manière efficace. Consultez les consignes concernant les taux de requêtes, et en particulier l'augmentation progressive des taux de requêtes.
Gestion des versions des objets
Vous est-il déjà arrivé de supprimer quelque chose par erreur et de ne pas avoir de sauvegarde ?
Google Cloud Storage est compatible avec
la gestion des versions des objets,
qui offre un moyen automatique de sauvegarder vos données et de les restaurer à partir de ces
sauvegardes. Vous pouvez activer la gestion des versions des objets à l'aide de la commande gsutil versioning set :
gsutil versioning set on gs://<your-cloud-storage-bucket>
Cloud Storage sélectionne toujours la version la plus récente. Par conséquent, si vous souhaitez restaurer un objet, vous devez utiliser l'une des autres API ou l'un des autres outils ci-dessus pour définir l'objet souhaité comme le plus récent.
Gestion du cycle de vie des objets
La possibilité d'archiver ou de supprimer automatiquement les fichiers obsolètes est une fonctionnalité utile pour de nombreuses applications. Heureusement, Google Cloud Storage fournit la gestion du cycle de vie des objets, qui vous permet de supprimer ou d'archiver des objets après un certain délai.
Prenons l'exemple d'une application de partage de photos pour laquelle vous souhaitez que toutes les photos soient supprimées dans un délai d'un jour. Vous pouvez configurer une règle de cycle de vie des objets comme suit :
// lifecycle.json { "lifecycle": { "rule": [ { "action": {"type": "Delete"}, "condition": {"age": 1} } ] } }
Et déployez-la à l'aide de la commande gsutil lifecycle set :
gsutil lifecycle set lifecycle.json gs://<your-cloud-storage-bucket>
Notez que cela s'applique à tous les fichiers du bucket. Par conséquent, si vous stockez des sauvegardes utilisateur importantes que vous souhaitez conserver pendant une longue période, ainsi que des photos que vous souhaitez supprimer quotidiennement, vous pouvez utiliser deux buckets distincts ou effectuer des suppressions manuellement avec gsutil ou votre propre serveur.
Google Cloud Functions (bêta)
Google Cloud Functions est une solution de calcul légère, asynchrone et basée sur les événements qui vous permet de créer de petites fonctions à application unique en réponse à des événements, sans gérer de serveur ni d'environnement d'exécution. Ces fonctions peuvent être utilisées pour transcoder des vidéos, classer des images à l'aide du machine learning ou synchroniser des métadonnées avec Firebase Realtime Database. Avec encore moins de surcharge que App Engine, Cloud Functions est le moyen le plus rapide de réagir aux modifications apportées à Cloud Storage.
Google Cloud Vision API
L'API Google Cloud Vision permet aux développeurs de comprendre le contenu d'une image en encapsulant des modèles de machine learning performants dans une API facile à utiliser. Elle classe rapidement les images dans des milliers de catégories, détecte les objets et les visages dans les images, trouve et lit les mots imprimés contenus dans les images, identifie les contenus offensants et fournit même une analyse des sentiments des images.
Google Cloud Speech API
Comme l'API Vision, l' API Google Cloud Speech permet aux développeurs d'extraire du texte d'un fichier audio stocké dans Cloud Storage. L'API reconnaît plus de 80 langues et variantes pour s'adapter à votre base mondiale d'utilisateurs. Lorsqu'elle est associée à l' API Google Cloud Natural Language, les développeurs peuvent à la fois extraire le texte brut et en déduire le sens. Si vous avez besoin d'une audience mondiale, associez-la à l' API Google Traduction pour traduire le texte dans plus de 90 langues.
Google App Engine
Cloud Storage for Firebase utilise deux formats de nommage différents pour les buckets par défaut selon la date de création du bucket :
- Bucket par défaut créé après
septembre 2024 : les buckets par défaut*.firebasestorage.app - Buckets par défaut hérités:
*.appspot.com
Google App Engine est une Platform as a Service qui met automatiquement à l’échelle la logique de backend en fonction du volume de trafic reçu. Importez simplement votre code de backend, et Google gérera la disponibilité de votre application. Vous n'avez pas besoin de provisionner ni de gérer de serveur. App Engine est un moyen rapide et simple d'ajouter de la puissance de traitement ou une exécution de confiance à votre application Firebase.
Intégration héritée App Engine
Si vous disposez d'un bucket par défaut *.appspot.com
Les environnements standards Java, Python et Go pour App Engine incluent l'API Images (Java | Python | Go), qui peut redimensionner, faire pivoter, retourner et recadrer une image, ainsi que renvoyer une URL de diffusion d'image permettant des transformations côté client, semblables à Cloudinary et Imgix.App Engine
Points à prendre en compte pour les buckets partagés
Si vous utilisez le bucket par défaut hérité *.appspot.com
Firebase Security Rules et fichiers App Engine : les fichiers importés à l'aide de App Engine partagent le même bucket et sont soumis aux mêmes configurations de sécurité. Si vous configurez vos Firebase Security Rules pour un accès public, les fichiers App Engine nouvellement importés seront également accessibles au public.
Définir des autorisations : lorsque vous importez un projet Google Cloud existant dans Firebase, vous devrez peut-être définir le contrôle des accès par défaut sur vos objets pour autoriser Firebase à y accéder. Exécutez la commande suivante à l'aide de
gsutil:gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
Problèmes connus pour Cloud Storage et App Engine
Il existe deux cas connus dans lesquels vous ne pouvez pas importer votre App Engine application :
Le projet contient une ancienne App Engine Datastore application maître/esclave.
L'ID de projet est préfixé par un domaine, par exemple :
domain.com:project-1234.
Dans l'un de ces cas, le projet n'est pas compatible avec Cloud Storage for Firebase, et vous devez créer un projet Firebase pour utiliser Cloud Storage. Si vous avez des questions, contactez l'assistance Firebase.