Premiers pas avec Firebase avec un projet Google Cloud existant

Un projet Firebase est un projet Google Cloud pour lequel des configurations et des services spécifiques à Firebase sont activés. C'est ce qu'on appelle communément "ajouter Firebase" à un projet Google Cloud. Cette page explique comment ajouter Firebase et répond à certaines questions fréquentes.

Lorsque vous ajoutez Firebase à un projet Google Cloud, Firebase active automatiquement plusieurs API et crée des comptes de service pour simplifier l'utilisation de tous les services et interfaces Firebase. Firebase ajoute également un libellé firebase:enabled à votre projet sur la page IAM et administration > Libellés de la console Google Cloud. Découvrez ce qui se passe lorsque vous ajoutez Firebase.

Relation entre un projet Firebase et un projet Google Cloud

Étant donné qu'un projet Firebase est un projet Google Cloud :

• Vous pouvez accéder au projet et interagir avec lui dans la console Firebase, ainsi que dans la console Google Cloud et la console Google APIs.

• Vous pouvez interagir avec le projet à l'aide de la CLI Firebase, de gcloud CLI et de n'importe quelle ressource Terraform de Google.

• Vous pouvez utiliser des produits et des API de Firebase et de Google Cloud dans le projet.

• Les autorisations et rôles IAM du projet sont partagés entre Firebase et Google Cloud. Tout accès d'un membre du projet (c'est-à-dire un compte principal) à votre projet Google Cloud s'applique également à votre projet Firebase (et inversement).

• La facturation du projet est partagée entre Firebase et Google Cloud. Si la facturation est activée sur votre projet Google Cloud, votre projet Firebase sera associé au forfait Blaze avec paiement à l'usage de Firebase.

• Les identifiants uniques du projet (comme le numéro de projet et l'ID de projet) sont partagés entre Firebase et Google Cloud.

• Toute hiérarchie des ressources appliquée à votre projet Google Cloud (par exemple, organisation, dossiers, etc.) s'appliquera également à votre projet Firebase.

• La suppression du projet entraîne sa suppression dans Firebase et Google Cloud.

• Toute suppression ou modification d'une ressource ou de données dans le projet s'applique à la fois à Firebase et à Google Cloud.

Ajouter Firebase à un projet Google Cloud existant

Vous pouvez "ajouter Firebase" à un projet Google Cloud existant à l'aide de l'une des options suivantes. Assurez-vous de disposer des autorisations requises pour ajouter Firebase au projet Google Cloud.

Sachez qu'une fois que vous avez"ajouté Firebase" à un projet Google Cloud existant, l'opération est irréversible (autrement dit, vous ne pouvez pas "supprimer Firebase" complètement du projet Google Cloud). Pour en savoir plus, consultez ces questions fréquentes.

Remarque : Pour accéder à toutes les fonctionnalités de Firebase et les utiliser dans un projet Google Cloud, vous devez accepter les Conditions d'utilisation de Firebase. En savoir plus sur l'obligation d'accepter les conditions d'utilisation de Firebase

Plus bas sur cette page, vous trouverez d'autres questions fréquentes et des conseils de dépannage pour "ajouter Firebase" à votre projet Google Cloud.

Console Firebase

1. Connectez-vous à la console Firebase avec le compte qui vous donne accès au projet Google Cloud existant.

2. Cliquez sur le bouton pour créer un projet Firebase.

3. En bas de la page, cliquez sur Ajouter Firebase au projet Google Cloud.

4. Dans le champ de texte, commencez à saisir le nom du projet existant, puis sélectionnez le projet dans la liste affichée.

5. Cliquez sur Ouvrir le projet.

6. Si vous y êtes invité, acceptez les Conditions d'utilisation de Firebase.

7. Suivez les instructions à l'écran pour ajouter Firebase et configurer un projet Firebase.

   Notez que l'activation de l'assistance IA dans la console Firebase et dans Google Analytics est facultative.

CLI Firebase

1. Si ce n'est pas déjà fait, installez la CLI Firebase.

2. Connectez-vous avec le même compte Google que celui qui vous donne accès au projet Google Cloud existant.

3. Exécutez la commande suivante :

   firebase projects:addfirebase

4. Lorsque vous y êtes invité, sélectionnez le projet Google Cloud existant dans la liste affichée.

Remarque : Si vous obtenez une erreur 403 PERMISSION_DENIED lorsque vous essayez d'ajouter Firebase à un projet Google Cloud existant, cela peut signifier que vous ne disposez pas des autorisations requises ou que vous n'avez pas accepté les conditions d'utilisation de Firebase.

API REST

1. Activez l'API Firebase Management dans le projet Google Cloud existant.

2. Générez votre jeton d'accès à l'API.

3. Activez les services Firebase pour le projet en appelant projects.addFirebase.

   Notez que vous aurez besoin du nom de ressource de votre projet pour effectuer cet appel.

Pour obtenir des instructions détaillées, consultez Ajouter des services Firebase à votre projet dans le guide Firebase "Configurer et gérer un projet Firebase à l'aide de l'API REST Management". Veillez à suivre toutes les instructions de la section Avant de commencer de ce guide.

Remarque : Si vous obtenez une erreur 403 PERMISSION_DENIED lorsque vous essayez d'ajouter Firebase à un projet Google Cloud existant, cela peut signifier que vous ne disposez pas des autorisations requises ou que vous n'avez pas accepté les conditions d'utilisation de Firebase.

Terraform

1. Activez l'API Firebase Management (firebase.googleapis.com) dans le projet Google Cloud existant.

2. Activez les services Firebase pour le projet à l'aide de la ressource google_firebase_project.

Pour en savoir plus sur l'utilisation de Firebase et Terraform, consultez Premiers pas avec Terraform et Firebase.

Remarque : Si vous obtenez une erreur 403 PERMISSION_DENIED lorsque vous essayez d'ajouter Firebase à un projet Google Cloud existant, cela peut signifier que vous ne disposez pas des autorisations requises ou que vous n'avez pas accepté les conditions d'utilisation de Firebase.

Questions fréquentes et dépannage

Faut-il accepter les conditions d'utilisation de Firebase pour commencer à utiliser Firebase ?

Pour accéder à toutes les fonctionnalités de Firebase et les utiliser dans un projet Google Cloud, vous devez accepter les Conditions d'utilisation de Firebase. Vous devez également accepter les conditions d'utilisation de Firebase pour "ajouter Firebase" à un projet Google Cloud existant.

Vous ne devez accepter les conditions d'utilisation de Firebase qu'une seule fois pour votre compte Google, quel que soit le nombre de projets auxquels vous avez accès. Lorsque vous acceptez les conditions, vous les acceptez pour votre compte Google. L'acceptation n'est pas effectuée au niveau du projet pour tous les membres du projet.

Vous pouvez accepter les conditions d'utilisation de Firebase via la console Firebase en utilisant l'une des options suivantes. Lorsque vous y êtes invité, acceptez les conditions d'utilisation. Si vous n'êtes pas invité à accepter les conditions d'utilisation de Firebase, cela signifie que vous les avez déjà acceptées.

• Acceptez les conditions d'utilisation de Firebase directement à l'aide du workflow d'acceptation des conditions d'utilisation.

• Créez un projet Firebase à l'aide de la console Firebase, puis acceptez les conditions d'utilisation de Firebase.

• Ouvrez un projet Firebase existant dans la console Firebase, puis acceptez les conditions d'utilisation de Firebase (par exemple, si quelqu'un vous a invité à devenir membre du projet, c'est-à-dire un compte principal).

• Ouvrez un projet Google Cloud existant dans la console Firebase, ajoutez-y Firebase, puis acceptez les conditions d'utilisation de Firebase.

Remarque : Vous ne pouvez pas accepter les conditions d'utilisation de Firebase à l'aide de la CLI Firebase, de l'API REST ou de Terraform. Elle ne peut être effectuée que via la console Firebase à l'aide de l'une des options décrites ci-dessus.

Important : Si vous avez signé une version hors connexion du Contrat-cadre Google Cloud pour l'utilisation de services Firebase spécifiés avec le même compte Google Cloud Platform, les Conditions d'utilisation de Firebase ne s'appliquent pas à votre utilisation de ces services Firebase, et vos conditions hors connexion régissent votre utilisation de ces services Firebase.

Quelles sont les autorisations requises pour "ajouter Firebase" ?

Pour "ajouter Firebase" à un projet Google Cloud existant, un membre du projet (c'est-à-dire un compte principal) doit disposer des autorisations IAM suivantes :

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Les rôles IAM Éditeur et Propriétaire contiennent ces autorisations par défaut.

Pourquoi la console Firebase ne parvient-elle pas à charger la liste de mes projets Google Cloud existants ?

Cette question fréquente s'applique le plus souvent si vous essayez d'ajouter Firebase à un projet Google Cloud existant à l'aide de la console Firebase et que vous avez accès à des milliers de projets Google Cloud.

La console Firebase n'est pas conçue pour charger des milliers de projets Google Cloud. Nous vous recommandons plutôt d'utiliser la CLI Firebase, l'API REST ou Terraform pour "ajouter Firebase" à votre projet Google Cloud existant.

Vous pouvez également consulter la question fréquente Pourquoi mon projet Firebase n'apparaît-il pas dans la liste de mes projets Firebase ?.

L'ajout du libellé firebase:enabled suffit-il pour ajouter Firebase ?

Tous les projets Firebase comportent un libellé firebase:enabled sur la page IAM et administration > Libellés de la console Google Cloud.

Toutefois, le simple fait d'ajouter manuellement le libellé firebase:enabled à la liste des libellés de votre projet n'active PAS les configurations et services spécifiques à Firebase pour votre projet Google Cloud. Pour ce faire, vous devez ajouter Firebase à l'aide de la console Firebase (ou, pour les cas d'utilisation avancés, à l'aide de la CLI Firebase, de l'API REST Firebase Management ou de Terraform).

Que se passe-t-il lorsque vous ajoutez Firebase à un projet Google Cloud existant ?

Un projet Firebase est un projet Google Cloud pour lequel des configurations et des services spécifiques à Firebase sont activés. Ainsi, lorsque vous "ajoutez Firebase" à un projet Google Cloud existant, Firebase effectue les actions suivantes pour simplifier l'utilisation de tous les services et interfaces Firebase :

• Ajoute le libellé firebase:enabled sur la page IAM et administration > Libellés de la console Google Cloud.

• Crée une clé API "Navigateur" et la limite automatiquement aux API liées à Firebase.

• Crée les comptes de service suivants :

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Active les API suivantes :

  • API App Engine Admin
  • API Cloud Pub/Sub
  • API Cloud Resource Manager
  • API Cloud Runtime Configuration
  • API Cloud Testing
  • API Firebase Cloud Messaging
  • API Firebase Dynamic Links
  • API Firebase Hosting
  • API Firebase Installations
  • API Firebase Management
  • API Firebase Remote Config
  • API Firebase Remote Config Realtime
  • API Firebase Rules
  • API Identity Toolkit
  • API Token Service

Puis-je supprimer Firebase d'un projet ?

Une fois que vous avez "ajouté Firebase" à un projet Google Cloud existant, vous ne pouvez pas annuler cette action (autrement dit, vous ne pouvez pas complètement "supprimer Firebase" du projet Google Cloud).

Le processus d'ajout de Firebase active les API et les services de backend qui peuvent être utilisés pour d'autres fonctionnalités Google Cloud. La désactivation de tous ces services activés peut entraîner des conséquences inattendues et involontaires en raison des dépendances.

Toutefois, si vous le souhaitez, vous pouvez désactiver manuellement toutes les API et supprimer l'étiquette, la clé API et les comptes de service automatiquement activés et créés lorsque vous avez "ajouté Firebase".

Avertissement : Si vous choisissez de désactiver et de supprimer manuellement ce qui s'est passé lors de l'ajout de Firebase, procédez avec une extrême prudence. Vous devez être absolument certain que votre projet Google Cloud et les applications associées n'utilisent rien en rapport avec ce que vous désactivez et supprimez. Sinon, votre projet ou votre application pourrait cesser de fonctionner ou se comporter de manière inattendue.

Puis-je bloquer l'ajout de Firebase à un projet Google Cloud existant ?

Bien que vous ne puissiez pas empêcher l'ajout de Firebase à un projet Google Cloud existant, vous pouvez procéder comme suit :

Limitez les membres du projet (c'est-à-dire les comptes principaux) disposant de l'autorisation IAM firebase.projects.update, qui est requise pour "ajouter Firebase".

Étapes suivantes

• Consultez les ressources suivantes pour en savoir plus sur les projets Firebase :

  • Comprendre les projets Firebase : fournit de brefs aperçus de plusieurs concepts importants concernant les projets Firebase, y compris leur relation avec Google Cloud et la hiérarchie de base d'un projet, de ses applications et de ses ressources.

  • Bonnes pratiques générales pour configurer des projets Firebase : fournit des bonnes pratiques générales de haut niveau pour configurer des projets Firebase et enregistrer vos applications dans un projet afin de disposer d'un workflow de développement clair qui utilise des environnements distincts.

• Commencez à utiliser Firebase dans vos applications mobiles et Web en enregistrant vos applications dans votre projet Firebase et en les connectant à Firebase : iOS+ | Android | Web | Flutter | Unity | C++.