Premiers pas avec Cloud Storage sur le Web

Cloud Storage pour Firebase vous permet de télécharger et de partager du contenu généré par les utilisateurs, tel que des images et des vidéos, ce qui vous permet de créer du contenu multimédia riche dans vos applications. Vos données sont stockées dans un Google Cloud Storage seau - une solution de stockage d'objets à l'échelle exaoctets avec haute disponibilité et redondance globale. Cloud Storage for Firebase vous permet de télécharger en toute sécurité ces fichiers directement à partir d'appareils mobiles et de navigateurs Web, en gérant facilement les réseaux irréguliers.

Conditions préalables

Ajouter et configurer le SDK Firebase dans votre application.

Créer un bucket Cloud Storage par défaut

  1. Dans le volet de navigation de la console Firebase , sélectionnez Stockage, puis cliquez sur démarrer.

  2. Consultez les messages sur la sécurisation de vos données Cloud Storage à l'aide de règles de sécurité. Au cours du développement, envisager la mise en place de vos règles d'accès du public .

  3. Sélectionnez un emplacement pour votre défaut seau Cloud Storage.

    • Ce paramètre de votre emplacement est de projet par défaut de Google Cloud Platform (GCP) Emplacement des ressources . Notez que cet endroit sera utilisé pour les services de GCP dans votre projet qui nécessite un paramètre d'emplacement, plus précisément, votre nuage Firestore base de données et votre App Engine application ( ce qui est nécessaire si vous utilisez Nuage Scheduler).

    • Si vous ne parvenez pas à sélectionner un emplacement, votre projet dispose déjà d'un emplacement de ressource GCP par défaut. Il a été défini soit lors de la création du projet, soit lors de la configuration d'un autre service nécessitant un paramètre d'emplacement.

    Si vous êtes sur le plan Blaze, vous pouvez créer plusieurs seaux , chacun avec son propre emplacement .

  4. Cliquez sur Terminé.

Configurer l'accès public

Cloud Storage pour Firebase fournit un langage de règles déclaratives qui vous permet de définir comment vos données doivent être structurées, comment elles doivent être indexées et quand vos données peuvent être lues et écrites. Par défaut, l'accès en lecture et en écriture à Cloud Storage est restreint afin que seuls les utilisateurs authentifiés puissent lire ou écrire des données. Pour commencer sans la mise en place d' authentification , vous pouvez configurer vos règles d'accès du public .

Cela rend Cloud Storage ouvert à tout le monde, même aux personnes n'utilisant pas votre application, alors assurez-vous de restreindre à nouveau votre Cloud Storage lorsque vous configurez l'authentification.

Ajouter l'URL de votre bucket à votre application

Si ce n'est pas déjà inclus, vous devez ajouter l' URL de votre seau Cloud Storage à votre objet de configuration de l' application Firebase .

  1. Accédez à votre tableau de bord de stockage dans la console Firebase .

  2. Cliquez sur l'onglet Fichiers, puis regardez dans l' en- tête de l'afficheur de fichiers.

  3. Copiez l'URL dans votre presse-papiers. Il est généralement sous la forme project-id .appspot.com .

  4. Pour votre firebaseConfig objet dans votre application, ajoutez l' storageBucket attribut avec l' URL de votre seau:

    Web v8

    // Set the configuration for your app
    // TODO: Replace with your app's config object
    var firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    firebase.initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    var storage = firebase.storage();

    Web v9

    import { initializeApp } from "firebase/app";
    import { getStorage } from "firebase/storage";
    
    // Set the configuration for your app
    // TODO: Replace with your app's config object
    const firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    const firebaseApp = initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    const storage = getStorage(firebaseApp);

Vous êtes prêt à commencer à utiliser Cloud Storage !

L'étape suivante? Apprenez à créer une référence Cloud Storage .

Configuration avancée

Il existe quelques cas d'utilisation qui nécessitent une configuration supplémentaire :

Le premier cas d'utilisation est parfait si vous avez des utilisateurs dans le monde entier et que vous souhaitez stocker leurs données près d'eux. Par exemple, vous pouvez créer des compartiments aux États-Unis, en Europe et en Asie pour stocker les données des utilisateurs de ces régions afin de réduire la latence.

Le deuxième cas d'utilisation est utile si vous avez des données avec des modèles d'accès différents. Par exemple : vous pouvez configurer un compartiment multirégional ou régional qui stocke des images ou d'autres contenus fréquemment consultés, et un compartiment Nearline ou Coldline qui stocke les sauvegardes des utilisateurs ou d'autres contenus rarement consultés.

Dans ces deux cas d'utilisation, vous souhaitez utiliser plusieurs seaux Cloud Storage .

Le troisième cas d'utilisation est utile si vous créez une application, comme Google Drive, qui permet aux utilisateurs d'avoir plusieurs comptes connectés (par exemple, un compte personnel et un compte professionnel). Vous pouvez utiliser une coutume Firebase App exemple pour authentifier chaque compte supplémentaire.

Utiliser plusieurs buckets Cloud Storage

Si vous souhaitez utiliser un autre seau Cloud Storage que le défaut fourni ci - dessus, ou utiliser plusieurs seaux Cloud Storage dans une seule application, vous pouvez créer une instance de firebase.storage que les références de votre seau sur mesure:

Web v8

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");

Web v9

import { getApp } from "firebase/app";
import { getStorage } from "firebase/storage";

// Get a non-default Storage bucket
const firebaseApp = getApp();
const storage = getStorage(firebaseApp, "gs://my-custom-bucket");

Utilisation de buckets importés

Lors de l' importation d' un seau existant Cloud Storage dans Firebase, vous devrez accorder Firebase la possibilité d'accéder à ces fichiers à l' aide du gsutil outil, inclus dans le SDK Google Cloud :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Vous pouvez trouver votre numéro de projet tel que décrit dans l' introduction aux projets Firebase .

Cela n'affecte pas les buckets nouvellement créés, car ceux-ci ont le contrôle d'accès par défaut défini pour autoriser Firebase. Il s'agit d'une mesure temporaire qui sera effectuée automatiquement à l'avenir.

Utiliser une application Firebase personnalisée

Si vous construisez une application plus complexe en utilisant une coutume firebase.app.App , vous pouvez créer une instance de firebase.storage.Storage initialisé avec cette application:

Web v8

// Get the default bucket from a custom firebase.app.App
var storage = customApp.storage();

// Get a non-default bucket from a custom firebase.app.App
var storage = customApp.storage("gs://my-custom-bucket");

Web v9

import { getStorage } from "firebase/storage";

// Get the default bucket from a custom firebase.app.App
const storage1 = getStorage(customApp);

// Get a non-default bucket from a custom firebase.app.App
const storage2 = getStorage(customApp, "gs://my-custom-bucket");

Prochaines étapes