Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

Cette page a été traduite par l'API Cloud Translation.

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.

Console Firebase

Accédez à la console Firebase.
Connectez-vous avec le même compte Google qui vous permet d'accéder au projet Google Cloud existant.
Cliquez sur Create a project (Créer un projet).
En bas de la page, cliquez sur le lien Vous avez déjà un projet Google Cloud ?.
Dans le champ de texte, commencez à saisir l'ID du projet existant, puis sélectionnez-le dans la liste affichée.
Cliquez sur Ouvrir le projet.
Si vous y êtes invité, acceptez les Conditions d'utilisation de Firebase.
Suivez les instructions à l'écran pour "ajouter Firebase" et configurer un projet Firebase.

Notez que l'activation de Google Analytics est facultative.

CLI Firebase

Si ce n'est pas déjà fait, installez la CLI Firebase.
Connectez-vous avec le même compte Google qui vous permet d'accéder au projet Google Cloud existant.
Exécutez la commande suivante :
```
firebase projects:addfirebase
```
Lorsque vous y êtes invité, sélectionnez le projet Google Cloud existant dans la liste affichée.
Si vous n'avez pas encore accepté les Conditions d'utilisation de Firebase, ouvrez un projet Firebase dans la console Firebase pour les accepter. Pour en savoir plus sur les conditions d'utilisation de Firebase, consultez cette FAQ.

API REST

Activez l'API Firebase Management dans le projet Google Cloud existant.
Générez votre jeton d'accès à l'API.
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.
Si vous n'avez pas encore accepté les Conditions d'utilisation de Firebase, ouvrez un projet Firebase dans la console Firebase pour les accepter. Pour en savoir plus sur les conditions d'utilisation de Firebase, consultez cette FAQ.

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.

Terraform

Activez l'API Firebase Management (firebase.googleapis.com) dans le projet Google Cloud existant.
Activez les services Firebase pour le projet à l'aide de la ressource google_firebase_project.
Si vous n'avez pas encore accepté les Conditions d'utilisation de Firebase, ouvrez un projet Firebase dans la console Firebase pour les accepter. Pour en savoir plus sur les conditions d'utilisation de Firebase, consultez cette FAQ.

Pour en savoir plus sur l'utilisation de Firebase et de Terraform, consultez la page Premiers pas avec Terraform et 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 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.

Pour accepter les conditions d'utilisation de Firebase, ouvrez le projet Firebase dans la console Firebase et suivez les instructions à l'écran.

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:
- service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
- firebase-service-account@firebase-sa-management.iam.gserviceaccount.com
- 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".

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++.