Un proyecto de Firebase es un proyecto de Google Cloud que tiene habilitados algunos parámetros de configuración y servicios específicos de Firebase adicionales. Esto se conoce comúnmente como "agregar Firebase" a un proyecto de Google Cloud. En esta página, se describe cómo "agregar Firebase", junto con algunas preguntas frecuentes (FAQ).
Cuando agregas Firebase a un proyecto de Google Cloud, Firebase habilita automáticamente
varias APIs y crea cuentas de servicio para simplificar el uso de todos los servicios y todas las
interfaces de Firebase. Firebase también agrega una
etiqueta firebase:enabled
a tu proyecto en la
página Etiquetas
de la consola de Google Cloud. Obtén más detalles sobre
qué sucede cuando "agregas Firebase".
Relación entre un proyecto de Firebase y un proyecto de Google Cloud
Ya que un proyecto de Firebase es un proyecto de Google Cloud, ocurre lo siguiente:
Puedes acceder al proyecto y también interactuar con él en Firebase console, así como en la consola de Google Cloud y en la Consola de APIs de Google.
Puedes interactuar con el proyecto con Firebase CLI, gcloud CLI y cualquier recurso de Terraform de Google.
Puedes usar productos y APIs tanto de Firebase como de Google Cloud en un proyecto.
Los roles y permisos de IAM para el proyecto se comparten entre Firebase y Google Cloud. Cualquier acceso que un miembro del proyecto (es decir, un principal) tenga a tu proyecto de Google Cloud también se aplicará a tu proyecto de Firebase (y viceversa).
La facturación del proyecto se comparte entre Firebase y Google Cloud. Si la facturación está habilitada en tu proyecto de Google Cloud, tu proyecto de Firebase formará parte del plan de precios Blaze de pago por uso de Firebase.
Los identificadores únicos del proyecto (como el número del proyecto y el ID del proyecto) se comparten entre Firebase y Google Cloud.
Cualquier jerarquía de recursos aplicada a tu proyecto de Google Cloud (por ejemplo, organización, carpetas, etc.) también se aplicará a tu proyecto de Firebase.
Si se borra el proyecto, se borra de Firebase y Google Cloud.
Si borras o modificas un recurso o datos dentro del proyecto, estos cambios se aplican a Firebase y Google Cloud.
Cómo agregar Firebase a un proyecto de Google Cloud existente
Puedes "agregar Firebase" a un proyecto de Google Cloud existente con cualquiera de las siguientes opciones. Asegúrate de tener los permisos necesarios para agregar Firebase al proyecto de Google Cloud.
Ten en cuenta que, una vez que "agregas Firebase" a un proyecto de Google Cloud existente, no se puede deshacer (es decir, no puedes "quitar Firebase" por completo del proyecto de Google Cloud). Obtén más información en estas Preguntas frecuentes.
Ir a Firebase console.
Accede con la misma Cuenta de Google que te permite acceder al proyecto de Google Cloud existente.
Haz clic en Create a project (Crear un proyecto).
En la parte inferior de la página, haz clic en el vínculo para la pregunta ¿Ya tienes un proyecto de Google Cloud?
En el campo de texto, comienza a ingresar el ID del proyecto existente y, luego, selecciónalo en la lista que aparece.
Haz clic en Abrir proyecto.
Si se te solicita, acepta las Condiciones de Firebase.
Sigue las instrucciones en pantalla para "agregar Firebase" y configurar un proyecto de Firebase.
Ten en cuenta que habilitar Google Analytics es opcional.
Si aún no lo hiciste, Instala la CLI de Firebase.
Accede con la misma Cuenta de Google que te permite acceder al proyecto de Google Cloud existente.
Ejecuta el siguiente comando:
firebase projects:addfirebase
Cuando se te solicite, selecciona el proyecto Google Cloud existente de la lista que se muestra.
Habilita la API de Firebase Management en el proyecto de Google Cloud existente.
Genera tu token de acceso a la API.
Para habilitar los servicios de Firebase para el proyecto, llama a
projects.addFirebase
.Ten en cuenta que necesitarás el nombre del recurso de tu proyecto para realizar esta llamada.
Para obtener instrucciones detalladas, consulta Agrega servicios de Firebase a tu proyecto en la guía de Firebase: "Configura y administra un proyecto de Firebase con la API de REST de Management". Asegúrate de seguir todas las instrucciones de la sección Antes de comenzar de esa guía.
Habilita la API de Firebase Management (
firebase.googleapis.com
) en el proyecto de Google Cloud existente.Habilita los servicios de Firebase para el proyecto con el recurso
google_firebase_project
.
Para obtener información detallada sobre el uso de Firebase y Terraform, consulta Comienza a usar Terraform y Firebase.
Preguntas frecuentes y solución de problemas
¿Es necesario aceptar las Condiciones del Servicio de Firebase para comenzar a usar Firebase?
Para acceder a todas las funciones de Firebase y usarlas en un proyecto de Google Cloud, debes aceptar las Condiciones del Servicio de Firebase. También debes aceptar las Condiciones de Firebase para "agregar Firebase" a un proyecto de Google Cloud existente.
Solo debes aceptar las Condiciones de Firebase una vez para tu Cuenta de Google, sin importar a cuántos proyectos tengas acceso. Cuando aceptas las condiciones, solo las aceptas para tu Cuenta de Google. La aceptación no se realiza a nivel del proyecto para todos los miembros.
Puedes aceptar las Condiciones de Firebase a través de la consola de Firebase con cualquiera de las siguientes opciones. Cuando se te solicite, acepta las Condiciones.
Crea un proyecto de Firebase nuevo con la consola de Firebase.
Abre un proyecto de Firebase existente en la consola de Firebase (por ejemplo, alguien te invitó a ser miembro del proyecto (es decir, una cuenta principal) del proyecto).
Abre un proyecto de Google Cloud existente en Firebase console y "agrega Firebase" a él.
¿Qué permisos se requieren para "agregar Firebase"?
Para "agregar Firebase" a un proyecto de Google Cloud existente, un miembro del proyecto (es decir, un principal) debe tener los siguientes permisos de IAM:
firebase.projects.update
resourcemanager.projects.get
serviceusage.services.enable
serviceusage.services.get
Los roles de IAM de editor y propietario contienen estos permisos de forma predeterminada.
¿Es suficiente agregar la etiqueta firebase:enabled
para agregar Firebase?
Todos los proyectos de Firebase tienen una
etiqueta firebase:enabled
en
la
página Etiquetas
de la consola de Google Cloud.
Sin embargo, agregar manualmente la etiqueta firebase:enabled
a tu lista de
etiquetas de proyecto NO habilita los parámetros de configuración y los servicios específicos de Firebase para
tu proyecto de Google Cloud. Para hacerlo, debes
agregar Firebase con Firebase console (o, en
casos de uso avanzados, con Firebase CLI, la API de REST para Firebase Management o
Terraform).
¿Qué sucede cuando "agregas Firebase" a un proyecto de Google Cloud existente?
Un proyecto de Firebase es un proyecto de Google Cloud que tiene habilitados algunos parámetros de configuración y servicios específicos de Firebase adicionales. Por lo tanto, cuando "agregas Firebase" a un proyecto de Google Cloud existente, Firebase realiza las siguientes acciones para simplificar el uso de todos los servicios y las interfaces de Firebase:
Agrega la etiqueta
firebase:enabled
en la página Etiquetas de la consola de Google Cloud.Crea una clave de API de "Navegador" y la restringe automáticamente a las APIs relacionadas con Firebase.
Crea las siguientes cuentas de servicio:
service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
Habilita las siguientes APIs:
- API de App Engine Admin
- API de Cloud Pub/Sub
- API de Cloud Resource Manager
- API de Cloud Runtime Configuration
- API de Cloud Testing
- API de Firebase Cloud Messaging
- API de Firebase Dynamic Links
- API de Firebase Hosting
- API de Firebase Installations
- API de Firebase Management
- API de Firebase Remote Config
- API en tiempo real para Firebase Remote Config
- API de reglas de Firebase
- API de Identity Toolkit
- API de Token Service
¿Puedo "quitar Firebase" de un proyecto?
Una vez que "agregas Firebase" a un proyecto de Google Cloud existente, no se puede deshacer (es decir, no puedes "quitar Firebase" por completo del proyecto de Google Cloud).
El proceso de "agregar Firebase" habilita las APIs y los servicios de backend que se pueden usar para otras funciones de Google Cloud. Inhabilitar todos estos servicios habilitados podría causar consecuencias inesperadas y no deseadas debido a las dependencias.
Sin embargo, si lo deseas, puedes inhabilitar manualmente todas las APIs y borrar la etiqueta, la clave de API y las cuentas de servicio que se habilitaron y crearon automáticamente cuando "agregaste Firebase".
¿Se puede bloquear la opción para "agregar Firebase" para un proyecto de Google Cloud existente?
Si bien no puedes bloquear la posibilidad de "agregar Firebase" a un proyecto de Google Cloud existente, puedes hacer lo siguiente:
Limita los miembros del proyecto (es decir, los principales) que tienen el permiso
de IAM firebase.projects.update
, que es necesario para "agregar Firebase".
Puedes usar una
política de denegación de IAM
para hacerlo de forma eficiente.
Próximos pasos
Consulta los siguientes recursos para obtener más información sobre los proyectos de Firebase:
Comprende los proyectos de Firebase: Se proporcionan descripciones generales breves de varios conceptos importantes sobre los proyectos de Firebase, incluida su relación con Google Cloud y la jerarquía básica de un proyecto y sus apps y recursos.
Prácticas recomendadas generales para configurar proyectos de Firebase: Se proporcionan prácticas recomendadas generales de alto nivel para configurar proyectos de Firebase y registrar tus apps en un proyecto para que tengas un flujo de trabajo de desarrollo claro que use entornos distintos.
Para comenzar a usar Firebase en tus apps web y para dispositivos móviles, regístralas con tu proyecto de Firebase y conéctalas a Firebase: iOS+ | Android | Web | Flutter | Unity | C++.