Premiers pas avec Firebase avec un projet Google Cloud existant

Un projet Firebase est un projet Google Cloud pour lequel certaines configurations et services spécifiques à Firebase sont activés. On parle généralement d'"ajout de Firebase" à un projet Google Cloud. Cette page explique comment ajouter Firebase, ainsi que 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. 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 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 du projet sont partagés entre Firebase et Google Cloud. Tout accès d'un membre de projet (c'est-à-dire d'un 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 pour votre projet Google Cloud, votre projet Firebase sera inclus dans le 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 de ressources appliquée à votre projet Google Cloud (organisation, dossiers, etc.) s'applique également à votre projet Firebase.

• La suppression du projet le supprime dans Firebase et Google Cloud.

• La suppression ou la 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 à l'aide de l'une des options suivantes. Assurez-vous de disposer des autorisations requises pour ajouter Firebase au projet Google Cloud.

Sachez que l'ajout de Firebase à un projet Google Cloud existant est une opération irréversible (c'est-à-dire que vous ne pouvez pas complètement "supprimer Firebase" du projet Google Cloud). Pour en savoir plus, consultez les questions fréquentes.

Remarque :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. Pour en savoir plus sur les conditions d'utilisation de Firebase, consultez les questions fréquentes.

Console Firebase

1. Accédez à la console Firebase.

2. Connectez-vous avec le même compte Google qui vous permet d'accéder au projet Google Cloud existant.

3. Cliquez sur Create a project (Créer un projet).

4. En bas de la page, cliquez sur le lien Vous avez déjà un projet Google Cloud ?.

5. Dans le champ de texte, commencez à saisir l'ID du projet existant, puis sélectionnez-le dans la liste affichée.

6. Cliquez sur Ouvrir le projet.

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

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

   Notez que l'activation de 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 permet d'accéder 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 un message d'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 la ressource de votre projet pour effectuer cet appel.

Pour obtenir des instructions détaillées, consultez la section 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 de Terraform, consultez la page 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, 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 à l'aide de 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, quelqu'un vous a invité à devenir membre du projet (c'est-à-dire un principal)).

• Ouvrez un Google Cloud existant dans la console Firebase et ajoutez 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. Vous ne pouvez le faire qu'à l'aide de la console Firebase.

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 autorisations sont requises pour "ajouter Firebase" ?

Pour "ajouter Firebase" à un projet Google Cloud existant, un membre du projet (c'est-à-dire un 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 incluent ces autorisations par défaut.

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

Tous les projets Firebase disposent d'un libellé firebase:enabled sur la page Libellés de la console Google Cloud.

Toutefois, l'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 certaines configurations et services spécifiques à Firebase sont activés. Ainsi, lorsque vous ajoutez Firebase à un projet Google Cloud existant, Firebase prend les mesures 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 en temps réel
  • 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 plus revenir en arrière (c'est-à-dire que vous ne pouvez pas complètement "supprimer Firebase" du projet Google Cloud).

Le processus d'ajout de Firebase active les API et les services backend pouvant être utilisés pour d'autres fonctionnalités Google Cloud. La désactivation de tous ces services activés pourrait avoir des conséquences inattendues et non intentionnelles 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 une extrême prudence. Vous devez être absolument certain que votre projet Google Cloud et les applications qui lui sont associées n'utilisent rien lié à ce que vous désactivez et supprimez. Sinon, votre projet ou votre application risque de ne plus fonctionner ou de se comporter de manière inattendue.

L'ajout de Firebase peut-il être bloqué pour un projet Google Cloud existant ?

Oui, vous pouvez bloquer la possibilité d'ajouter Firebase à un projet Google Cloud existant. Vous avez le choix entre différentes options :

• Bloquez l'activation de l'API firebase.googleapis.com à l'aide d'une contrainte "Restreindre les API et les services Google Cloud autorisés".

• 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". Pour ce faire, vous pouvez utiliser une stratégie de refus IAM.

Étapes suivantes

• Pour en savoir plus sur les projets Firebase, consultez les ressources suivantes:

  • 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 et générales 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 auprès de votre projet Firebase et en les connectant à Firebase : iOS+ | Android | Web | Flutter | Unity | C++.