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 Firebase spécifiques supplémentaires sont activés. On parle généralement d'ajouter Firebase à un projet Google Cloud. Cette page décrit 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 Libellés de la console Google Cloud. Pour en savoir plus sur 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 toute ressource Terraform de Google.

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

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

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

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

• Toute hiérarchie de 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 à Firebase et à Google Cloud.

Ajouter Firebase à un projet Google Cloud existant

Vous pouvez "ajouter Firebase" à un projet Google Cloud existant en utilisant 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, vous ne pouvez plus revenir en arrière (c'est-à-dire que vous ne pouvez pas supprimer complètement Firebase 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. Pour en savoir plus sur les conditions d'utilisation de Firebase, consultez ces questions fréquentes.

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 dans la liste qui s'affiche.

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 par IA dans la console Firebase et 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 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 recevez 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 de gestion". Veillez à suivre toutes les instructions de la section Avant de commencer de ce guide.

Remarque : Si vous recevez 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 recevez 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

Dois-je accepter les conditions d'utilisation de Firebase pour commencer à utiliser Firebase ?

Pour accéder à toutes les fonctionnalités de Firebase dans un projet Google Cloud et les utiliser, 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 n'avez besoin d'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 d'utilisation, vous ne les acceptez que pour votre compte Google. L'acceptation n'est pas au niveau du projet pour tous les membres du projet.

Vous pouvez accepter les conditions d'utilisation de Firebase dans la console Firebase en utilisant l'une des options suivantes. Lorsque vous y êtes invité, acceptez les conditions d'utilisation.

• Créez un projet Firebase à l'aide de la console Firebase.

• Ouvrez un projet Firebase existant dans la console Firebase (par exemple, si quelqu'un vous a invité à devenir membre (c'est-à-dire un principal) du projet).

• Ouvrez un Google Cloud existant dans la console Firebase et ajoutez-y Firebase.

Remarque : Il n'est pas possible d'accepter les conditions d'utilisation de Firebase à l'aide de la CLI Firebase, de l'API REST ou de Terraform. Vous ne pouvez le faire que dans la console Firebase.

Important : Si vous avez signé une version hors connexion du Contrat-cadre Google Cloud pour l'utilisation de certains services Firebase 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 autorisations sont 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.

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

Tous les projets Firebase sont associés au libellé firebase:enabled sur la page Libellés de la console Google Cloud.

Toutefois, le simple ajout manuel du libellé firebase:enabled à votre liste de libellés de 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 Firebase spécifiques supplémentaires 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 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 (c'est-à-dire que vous ne pouvez pas supprimer complètement Firebase du projet Google Cloud).

Le processus d'ajout de Firebase active des API et des 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 indésirables en raison des dépendances.

Toutefois, si vous le souhaitez, vous pouvez désactiver manuellement toutes les API et supprimer le libellé, la clé API et les comptes de service activés et créés automatiquement 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, faites-le avec la plus grande prudence. Vous devez être absolument certain que votre projet Google Cloud et les applications associées au projet n'utilisent rien en rapport avec ce que vous désactivez et supprimez. Sinon, votre projet ou votre application pourraient 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 réellement empêcher l'ajout de Firebase à un projet Google Cloud existant, vous pouvez effectuer les actions suivantes :

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

Étapes suivantes

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

  • Comprendre les projets Firebase : fournit un bref aperçu 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 avec 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++.