Migra las Extensiones de Firebase a kits de funciones

En esta guía, se muestra cómo migrar tus extensiones del entorno obsoleto Firebase Extensions a un kit de funciones que puedes instalar e implementar en tu propia base de código de Cloud Functions para Firebase (2ª gen.).

Firebase Extensions administró todos los aspectos de la creación, actualización y eliminación de extensiones. Los kits de funciones empaquetan las capacidades de las extensiones como Cloud Functions for Firebase típicas de 2ª gen. Como los kits de funciones son Cloud Functions estándar, puedes crearlos, actualizarlos, borrarlos y solucionar problemas relacionados con ellos con la CLI de Firebase en tu proyecto de Firebase. Esta guía te prepara para administrar tus funciones ahora y adoptar las actualizaciones a medida que estén disponibles.

En esta guía, se usa la extensión Transmite Cloud Firestore a BigQuery (firestore-bigquery-export) como ejemplo para mostrarte los comandos y el resultado del comando para cada paso de la migración.

Determina tu ruta de migración

Firebase alienta a todos los publicadores de Firebase Extensions a crear reemplazos para sus extensiones como kits de funciones publicados en npm. Puedes verificar si hay un reemplazo del kit de funciones disponible para tus extensiones de varias maneras:

  • Ve a la página Extensiones de la consola de Firebase de tu proyecto. Cada extensión que instalaste indica si tiene un reemplazo de kit de funciones disponible.

  • Ejecuta firebase ext:list dentro de tu proyecto de Firebase en una terminal para ver cuáles de tus extensiones instaladas tienen reemplazos oficiales:

    firebase ext:list --project my-project

    i  extensions: ensuring required API firebaseextensions.googleapis.com is enabled...
✔  extensions: required API firebaseextensions.googleapis.com is enabled
i  extensions: list of extensions installed in my-project:
┌────────────────────────────────────┬───────────┬────────────────────────────────┬────────┬─────────┬─────────────────────┬───────────────────────────────────────────────────┐
│ Extension                          │ Publisher │ Instance ID                    │ State  │ Version │ Your last update    │ Replacement Kit                                   │
├────────────────────────────────────┼───────────┼────────────────────────────────┼────────┼─────────┼─────────────────────┼───────────────────────────────────────────────────┤
│ firebase/firestore-bigquery-export │ firebase  │ firestore-bigquery-export-zbrp │ ACTIVE │ 0.3.2   │ 2026-06-10 18:35:03 │ @firebase-function-kits/firestore-bigquery-export │
├────────────────────────────────────┼───────────┼────────────────────────────────┼────────┼─────────┼─────────────────────┼───────────────────────────────────────────────────┤
│ firebase/storage-resize-images     │ firebase  │ storage-resize-images          │ ACTIVE │ 0.3.6   │ 2026-06-03 17:41:24 │                                                   │
└────────────────────────────────────┴───────────┴────────────────────────────────┴────────┴─────────┴─────────────────────┴───────────────────────────────────────────────────┘
⚠ Notice: Firebase Extensions will shut down on March 31, 2027. Learn more: https://firebase.google.com/docs/extensions/faq-and-troubleshooting

Si hay un reemplazo oficial del kit de funciones disponible para tu extensión, puedes migrarla con la sección Migra a kits de funciones en npm.

Si no encuentras un reemplazo publicado, puedes bifurcar el código de la extensión y crear tu propio reemplazo, ya que todas las extensiones son de código abierto. Para ello, sigue la guía Migra a un kit de funciones creado por ti.

Selecciona la ruta de migración: Migra a kits de funciones en npm Migra a un kit de funciones creado por ti

Migra a kits de funciones en npm

Verifica si hay limitaciones conocidas de la migración

Antes de comenzar a migrar una instancia de extensión, verifica si tu configuración usa alguna de las siguientes funciones que requieren una solución alternativa o que aún no se admiten en los kits de funciones:

  • Los repositorios de Docker personalizados y las claves de KMS requieren una solución alternativa manual Cloud Functions for Firebase no admite parámetros del sistema de reemplazo para configurar un repositorio de Docker personalizado o una clave de encriptación administrada por el cliente (clave de KMS). Si tu extensión configura alguno de estos parámetros, consulta la solución alternativa de las Preguntas frecuentes.

Antes de comenzar

Debes configurar la CLI de Firebase y, luego, inicializar un proyecto de Firebase. Cuando uses la CLI, asegúrate de usar la versión >= 15.32.0 de firebase-tools, que tiene los nuevos comandos de migración y del kit de funciones.

Roles y permisos de la cuenta obligatorios

Según lo que deba crear y configurar la CLI de Firebase durante la migración, la cuenta que uses para autenticarte con Firebase y Google Cloud debe tener los siguientes roles:

  • roles/firebaseextensions.editor
  • roles/cloudbuild.builds.editor
  • roles/artifactregistry.writer
  • roles/run.developer
  • roles/iam.serviceAccountUser
  • roles/iam.serviceAccountCreator
  • roles/cloudfunctions.admin (si necesitas hacer setIamPermissions para los extremos públicos)
  • roles/secretmanager.admin (si se usan Secrets)
  • roles/serviceusage.serviceUsageAdmin (si necesitas habilitar APIs nuevas)

Te recomendamos que uses una cuenta que ya haya instalado extensiones y que haya implementado funciones, ya que la mayoría de estos permisos ya se habrán otorgado. Si tu cuenta de migración necesita más roles, sigue las instrucciones de IAM de Google Cloud para agregarlos.

Elige un flujo de trabajo de la CLI

Para migrar de una instancia de extensión a un kit de funciones disponible en npm, elige una de las siguientes opciones:

  • (Recomendado) Migra con el comando de la CLI de ext:migrate. Este comando implementa el reemplazo del kit de funciones antes de desinstalar la extensión que reemplaza.
  • Migra con los comandos de la CLI de kits de funciones. Puedes usar comandos separados para actualizar la extensión, instalar un kit de funciones, configurarlo como la extensión, implementar el kit y desinstalar la extensión. Esto proporciona más flexibilidad para reordenar los comandos o realizar trabajo adicional entre los pasos.

Migra con ext:migrate

Una vez por instancia de extensión, ejecuta el siguiente comando para iniciar una migración:

firebase ext:migrate --project <project-id>

Este comando te guiará por los siguientes pasos:

  1. Seleccionar una extensión para migrar que tenga disponible un reemplazo oficial de kit de funciones
  2. Seleccionar una instancia específica de esa extensión
  3. Actualizar la extensión a su versión más reciente si es necesario
  4. Instalar el kit de funciones y configurar una instancia de forma idéntica a como se configura la instancia de la extensión
  5. Implementando el kit de funciones.
  6. Verificar que el kit de funciones se haya implementado correctamente y que se hayan ejecutado todos los hooks del ciclo de vida, si los hay.
  7. Desinstalar la instancia de la extensión

Si conoces la extensión o instancia de extensión específica que quieres migrar, especifícala con las siguientes marcas de línea de comandos:

firebase ext:migrate --extension firebase/firestore-bigquery-export --project <project-id>

# or

firebase ext:migrate --ext-instance firestore-bigquery-export-abcd --project <project-id>

Si conoces el paquete específico al que deseas migrar, en especial si no es un paquete de reemplazo oficial que indique Google, especifícalo con la marca --package:

firebase ext:migrate --ext-instance firestore-bigquery-export-abcd --package @firebase-function-kits/firestore-bigquery-export --project <project-id>

Verifica la implementación de un kit de funciones

Para verificar que el firebase deploy del kit no haya tenido errores, revisa los registros de implementación para ver si se activó algún hook del ciclo de vida. Las extensiones populares, como Transmitir Cloud Firestore a BigQuery, usan hooks de ciclo de vida. A continuación, se muestra un ejemplo de cómo se ve un hook de ciclo de vida cuando se activa:

i  functions: Executing afterFirstDeploy lifecycle hook targeting: kit-firestore-bigquery-export-initBigQuerySync...
✔  functions: Successfully queued task for lifecycle hook kit-firestore-bigquery-export-initBigQuerySync in queue projects/my-project/locations/europe-west1/queues/kit-firestore-bigquery-export-initBigQuerySync.
i  functions: View logs for afterFirstDeploy at: https://console.cloud.google.com/logs/query;query=resource.type%3D%22cloud_run_revision%22%0Aresource.labels.service_name%3D%22kit-firestore-bigquery-export--initbigquerysync%22%0Aresource.labels.location%3D%22europe-west1%22;project=my-project

Estos mensajes de registro confirman lo siguiente:

  • Se encontró y ejecutó un hook de ciclo de vida.
  • Se puso en cola una tarea en la lista de tareas en cola asociada del hook del ciclo de vida.
  • Se proporcionó un vínculo a Cloud Logging para que puedas validar que la tarea se completó sin errores.

Sigue el vínculo de los registros a la consola de Google Cloud para validar que no haya errores en los registros y que el evento de la lista de tareas en cola se haya procesado correctamente. Si el evento de ciclo de vida no se ejecutó correctamente, puedes volver a activarlo con el siguiente comando:

firebase functions:lifecycle:run <hook-name> <codebase>

Si es la primera vez que implementas una instancia de kit de funciones, ejecuta lo siguiente:

firebase functions:lifecycle:run afterFirstDeploy <kit-instance-id>

Si en cualquier momento durante la validación decides que quieres detener o deshacer esta migración, puedes desinstalar el kit con las instrucciones que se indican en Desinstala la extensión.

Una vez que hayas verificado que la implementación inicial de tu kit de funciones se completó correctamente, debes validar que la funcionalidad del kit esté funcionando como se espera. Como la extensión en sí sigue ejecutándose, debes tener cuidado de que lo que estás verificando no sea solo que una de las dos haya funcionado, ya que la extensión ha estado funcionando y seguirá haciéndolo.

En el caso de que el procesamiento no cambie y no veas resultados duplicados de la extensión y el kit, la mejor opción es examinar directamente los registros del kit después de activar su funcionalidad.

Ejemplo práctico: Transmite Cloud Firestore a BigQuery

Con la extensión Stream Cloud Firestore to BigQuery, las escrituras en la tabla de registro de cambios sin procesar (*_raw_changelog) y en la tabla de vista más reciente (*_raw_latest) se desduplicarán si se entrega el mismo evento al kit y a la extensión. Por lo tanto, no puedes usar la presencia de filas o filas duplicadas en BigQuery para validar que el kit funcione.

Puedes ver los registros de las funciones poco después de escribir en tu colección de Firestore con firebase functions:logs y buscar una entrada de registro que indique que se procesó correctamente una escritura. Para este kit con el ID de instancia predeterminado de firestore-bigquery-export, se vería de la siguiente manera:

2026-09-25T19:52:46.328612Z I kit-firestore-bigquery-export-fsexportbigquery: Started execution of extension
2026-09-25T19:52:46.328644Z I kit-firestore-bigquery-export-fsexportbigquery: {"message":"Firestore event received by onDocumentWritten trigger","document_name":"projects/extensions-eventarc-testing/databases/(default)/documents/exported-messages/cmGP6XLyksqGdw2OgTOq","operation":0,"event_id":"9f59a2a4-1a5e-4c41-a32d-561e3c734502"}
2026-09-25T19:52:46.616064Z I kit-firestore-bigquery-export-fsexportbigquery: Completed execution of extension
2026-09-2

Si tienes muchos registros, puedes filtrarlos para ver una función específica del kit con el siguiente comando:

firebase functions:log --only <function name>

Para encontrar los nombres de las funciones específicas de una instancia de kit, puedes usar el siguiente comando:

firebase functions:list | grep kit-<kit instance id>

En este ejemplo, sucede lo siguiente:

firebase functions:list | grep kit-firestore-bigquery-export
│ kit-firestore-bigquery-export-fsexportbigquery  │ v2      │ google.cloud.firestore.document.v1.written                    │
│ kit-firestore-bigquery-export-initBigQuerySync  │ v2      │ taskQueue                                                     │
│ kit-firestore-bigquery-export-setupBigQuerySync │ v2      │ taskQueue                                                     │
│ kit-firestore-bigquery-export-syncBigQuery      │ v2      │ taskQueue                                                     │

Revisa el archivo README del kit de funciones

Es posible que algunos kits requieran trabajo adicional más allá de lo que se controla automáticamente con los kits de funciones. Revisa el archivo README del kit que estás instalando y sigue las instrucciones adicionales.

Migra con la CLI de kits de funciones

Antes de comenzar, identifica y anota el ID de instancia de la extensión que quieres migrar a un kit y el nombre del paquete de npm de su kit de reemplazo. Puedes encontrar ambos con el resultado de firebase ext:list. Consulta Determina tu ruta de migración para ver un ejemplo de uso de ext:list.

1. Actualiza tu instancia de extensión a la versión más reciente

Debes actualizar tu extensión a la versión más reciente para minimizar la diferencia entre la instancia de la extensión y su kit de reemplazo. Si no actualizas la extensión, es posible que haya cambios rotundos significativos entre la instancia de la extensión y el kit que la reemplaza. Es posible que la configuración exportada no coincida con lo que espera el kit debido a los cambios de parámetros entre las versiones.

Usa una de las siguientes opciones para actualizar la extensión, según dónde se haya instalado:

  • Desde la consola deFirebase
  • Desde la CLI de Firebase con lo siguiente:
    • firebase ext:update <extension-instance-id> --project <project-id> firebase deploy --only extensions --project <project-id>

Si omites este paso, la CLI te solicitará que actualices cuando exportes la configuración si tu extensión no tiene la versión más reciente.

2. Revisa e instala la instancia de reemplazo del kit de funciones

Puedes instalar el kit de funciones con el siguiente comando de la CLI:

firebase functions:kits:install --template migration --no-configure --package <npm-package-name> --project <project-id>

Cuando elijas un ID de instancia para tu kit durante la instalación, asegúrate de anotarlo para usarlo más adelante en las instrucciones de migración.

Una vez que se instala el kit, se crea un directorio nuevo dentro de tu proyecto de Firebase con una ubicación como function-kits/<kit-name>/source que contiene el paquete de npm con el kit que reemplaza tu extensión y un archivo index.ts básico que exporta esas funciones para que Firebase las implemente y establezca una configuración personalizada.

Revisa el archivo README del kit y sigue las instrucciones adicionales que se indican allí.

Si tienes varias instancias del kit en el mismo proyecto, puedes repetir este comando para crear instancias nuevas del mismo kit. También puedes implementar una sola instancia de kit en dos proyectos de Firebase diferentes con parámetros de configuración distintos (por ejemplo, un proyecto de etapa de pruebas y otro de producción). Para obtener más información sobre estas configuraciones avanzadas, consulta Migraciones avanzadas.

Ejemplo práctico:

firebase functions:kits:install --template migration --no-configure --package @firebase-function-kits/firestore-bigquery-export --project my-project

3. Configura la instancia del kit de funciones de forma idéntica a la extensión

Debes personalizar esta instancia del kit con una configuración idéntica a la de la extensión que reemplaza. Puedes exportar la configuración de tu instancia de extensión a un archivo .env, que almacena los datos de configuración de parámetros, variables de entorno y referencias de secretos para todos los Cloud Functions, incluidos los kits. Para exportarla directamente al archivo de configuración de tu kit, ejecuta lo siguiente:

firebase ext:export --mode functions --instance <extension-instance-id> --kit-instance <kit-instance-id> --project <project-id>

Al final de este paso, la información de configuración de esta instancia se almacena en un archivo .env específico del proyecto en el directorio de configuración de la instancia, como function-kits/<kit-name>/config-<instance-id>/.env.<project-id>

4. Implementa y verifica el reemplazo del kit

Ahora que el kit está instalado y disponible como un conjunto de funciones, puedes implementar el reemplazo del kit. Los kits de funciones funcionan como las funciones estándar, en las que cada instancia de kit actúa como una base de código independiente para organizar tus funciones. Puedes elegir implementar todas tus funciones o solo una instancia de kit específica. Cuando migres una sola instancia de extensión, implementa solo esa instancia del kit.

Si tu kit usa parámetros nuevos que no estaban presentes en la instancia de la extensión desde la que migraste, la CLI de Firebase te los solicitará al comienzo del proceso de implementación. Esto no se espera en este ejemplo de trabajo de una extensión de firestore-bigquery-export actualizada, pero muchos kits solicitan un parámetro nuevo para cualquier fuente de activador de eventos que use el kit. Como parte de esta migración, los kits actualizados usan funciones de 2ª gen. en las que las extensiones antes usaban funciones de 1ª gen. En la 2ª gen., las funciones se ubican cerca de sus fuentes de eventos y se agregan como un parámetro adicional. En las actualizaciones futuras, si se agregan parámetros nuevos, la CLI te los solicitará en la próxima implementación.

Ejemplo práctico:

firebase deploy --only functions:firestore-bigquery-export --project my-project

Resultado:

=== Deploying to 'my-project'...
i  deploying functions
i  functions: Loaded environment variables from function-kits/firestore-bigquery-export/config-firestore-bigquery-export/.env.my-project
i  functions: ensuring required API bigquery.googleapis.com is enabled...
i  functions: ensuring required API cloudtasks.googleapis.com is enabled...
✔  functions: required APIs are enabled
i  functions: granting declarative IAM roles to managed service account:
   - BigQuery Data Editor
   - BigQuery User
   - Cloud Datastore User
   - Eventarc Event Receiver
   - roles/run.invoker
✔  functions: successfully granted IAM roles
i  functions: creating Node.js 22 (2nd Gen) function kit-firestore-bigquery-export-fsexportbigquery(us-central1)...
i  functions: creating Node.js 22 (2nd Gen) function kit-firestore-bigquery-export-initBigQuerySync(us-central1)...
i  functions: creating Node.js 22 (2nd Gen) function kit-firestore-bigquery-export-setupBigQuerySync(us-central1)...
✔  functions[kit-firestore-bigquery-export-fsexportbigquery(us-central1)] Successful create operation.
✔  functions[kit-firestore-bigquery-export-initBigQuerySync(us-central1)] Successful create operation.
✔  functions[kit-firestore-bigquery-export-setupBigQuerySync(us-central1)] Successful create operation.
i  functions: Executing afterFirstDeploy lifecycle hook targeting: kit-firestore-bigquery-export-initBigQuerySync...
✔  functions: Successfully queued task for lifecycle hook kit-firestore-bigquery-export-initBigQuerySync in queue projects/my-project/locations/us-central1/queues/kit-firestore-bigquery-export-initBigQuerySync.
✔  Deploy complete!

Para verificar que el firebase deploy del kit no haya tenido errores, revisa los registros de implementación para ver si se activó algún hook del ciclo de vida. Las extensiones populares, como Transmitir Cloud Firestore a BigQuery, usan hooks de ciclo de vida. A continuación, se muestra un ejemplo de cómo se ve un hook de ciclo de vida cuando se activa:

i  functions: Executing afterFirstDeploy lifecycle hook targeting: kit-firestore-bigquery-export-initBigQuerySync...
✔  functions: Successfully queued task for lifecycle hook kit-firestore-bigquery-export-initBigQuerySync in queue projects/my-project/locations/europe-west1/queues/kit-firestore-bigquery-export-initBigQuerySync.
i  functions: View logs for afterFirstDeploy at: https://console.cloud.google.com/logs/query;query=resource.type%3D%22cloud_run_revision%22%0Aresource.labels.service_name%3D%22kit-firestore-bigquery-export--initbigquerysync%22%0Aresource.labels.location%3D%22europe-west1%22;project=my-project

Estos mensajes de registro confirman lo siguiente:

  • Se encontró y ejecutó un hook de ciclo de vida.
  • Se puso en cola una tarea en la lista de tareas en cola asociada del hook del ciclo de vida.
  • Se proporcionó un vínculo a Cloud Logging para que puedas validar que la tarea se completó sin errores.

Sigue el vínculo de los registros a la consola de Google Cloud para validar que no haya errores en los registros y que el evento de la lista de tareas en cola se haya procesado correctamente. Si el evento de ciclo de vida no se ejecutó correctamente, puedes volver a activarlo con el siguiente comando:

firebase functions:lifecycle:run <hook-name> <codebase>

Si es la primera vez que implementas una instancia de kit de funciones, ejecuta lo siguiente:

firebase functions:lifecycle:run afterFirstDeploy <kit-instance-id>

Si en cualquier momento durante la validación decides que quieres detener o deshacer esta migración, puedes desinstalar el kit con las instrucciones que se indican en Desinstala la extensión.

Una vez que hayas verificado que la implementación inicial de tu kit de funciones se completó correctamente, debes validar que la funcionalidad del kit esté funcionando como se espera. Como la extensión en sí sigue ejecutándose, debes tener cuidado de que lo que estás verificando no sea solo que una de las dos haya funcionado, ya que la extensión ha estado funcionando y seguirá haciéndolo.

En el caso de que el procesamiento no cambie y no veas resultados duplicados de la extensión y el kit, la mejor opción es examinar directamente los registros del kit después de activar su funcionalidad.

Ejemplo práctico: Transmite Cloud Firestore a BigQuery

Con la extensión Stream Cloud Firestore to BigQuery, las escrituras en la tabla de registro de cambios sin procesar (*_raw_changelog) y en la tabla de vista más reciente (*_raw_latest) se desduplicarán si se entrega el mismo evento al kit y a la extensión. Por lo tanto, no puedes usar la presencia de filas o filas duplicadas en BigQuery para validar que el kit funcione.

Puedes ver los registros de las funciones poco después de escribir en tu colección de Firestore con firebase functions:logs y buscar una entrada de registro que indique que se procesó correctamente una escritura. Para este kit con el ID de instancia predeterminado de firestore-bigquery-export, se vería de la siguiente manera:

2026-09-25T19:52:46.328612Z I kit-firestore-bigquery-export-fsexportbigquery: Started execution of extension
2026-09-25T19:52:46.328644Z I kit-firestore-bigquery-export-fsexportbigquery: {"message":"Firestore event received by onDocumentWritten trigger","document_name":"projects/extensions-eventarc-testing/databases/(default)/documents/exported-messages/cmGP6XLyksqGdw2OgTOq","operation":0,"event_id":"9f59a2a4-1a5e-4c41-a32d-561e3c734502"}
2026-09-25T19:52:46.616064Z I kit-firestore-bigquery-export-fsexportbigquery: Completed execution of extension
2026-09-2

Si tienes muchos registros, puedes filtrarlos para ver una función específica del kit con el siguiente comando:

firebase functions:log --only <function name>

Para encontrar los nombres de las funciones específicas de una instancia de kit, puedes usar el siguiente comando:

firebase functions:list | grep kit-<kit instance id>

En este ejemplo, sucede lo siguiente:

firebase functions:list | grep kit-firestore-bigquery-export
│ kit-firestore-bigquery-export-fsexportbigquery  │ v2      │ google.cloud.firestore.document.v1.written                    │
│ kit-firestore-bigquery-export-initBigQuerySync  │ v2      │ taskQueue                                                     │
│ kit-firestore-bigquery-export-setupBigQuerySync │ v2      │ taskQueue                                                     │
│ kit-firestore-bigquery-export-syncBigQuery      │ v2      │ taskQueue                                                     │

5. Desinstala la extensión

Cuando hayas verificado el kit de funciones implementado, puedes desinstalar la extensión para no duplicar su comportamiento, una vez para el kit y otra para la extensión. Puedes desinstalar todas las extensiones desde la CLI de Firebase, sin importar cómo las instalaste, si pasas la marca --immediate:

firebase ext:uninstall <extension-instance-id> --project <project-id> --immediate

Ejemplo práctico:

firebase ext:uninstall firestore-bigquery-export --project my-project --immediate

Resultado:

i  extensions: uninstalling firestore-bigquery-export...
i  extensions: deleting extension instance resources in project my-project...
✔  extensions: successfully uninstalled firestore-bigquery-export

Migraciones avanzadas

Puedes tener extensiones en varios proyectos de Firebase que quieras administrar con una sola base de código. Por ejemplo, si implementas la misma infraestructura en un entorno de testing y un entorno de production, cada uno de los cuales tiene una instancia de documents Cloud Firestore que exportas a BigQuery, es posible que tengas instaladas dos instancias de la extensión firestore-bigquery-export:

  • export-documents-testing
  • export-documents-production

Si migraste estas dos instancias de extensión a dos instancias de kit de funciones en una sola base de código cuando trabajabas con la CLI de Firebase y las implementaste con firebase deploy --project testing y firebase deploy --project production, cada implementación crearía dos instancias en los entornos de testing y production.

En su lugar, reemplaza las dos instancias de extensión por una instancia de kit de funciones de firestore-bigquery-export implementada en varios proyectos, en los que cada proyecto tiene su propia configuración. El directorio de configuración de la instancia debería verse de la siguiente manera:

  • config-export-documents/
    • .env.testing
    • .env.production

Cada implementación en testing y production crea una instancia de tu kit con la configuración correspondiente. Los comandos de la CLI existentes crean esta configuración siempre que pases la marca --project en cada invocación de ext:migrate o functions:kits:install.

Ejemplo práctico:

firebase functions:kits:install --package @firebase-function-kits/firestore-bigquery-export --project testing --no-configure --template migration

✔ What would you like to name this kit? firestore-bigquery-export
✔ What would you like to name this instance? export-documents
✔  Wrote function-kits/firestore-bigquery-export/source/package.json
✔  Wrote function-kits/firestore-bigquery-export/source/tsconfig.json
✔  Wrote function-kits/firestore-bigquery-export/source/.gitignore
✔  Wrote function-kits/firestore-bigquery-export/source/src/index.ts
i  functions: Running npm install
✔  Wrote configuration info to firebase.json
✔  functions: Function kit firestore-bigquery-export successfully installed.

# This creates the export-documents instance with an empty .env.testing file
# for the testing project. Now populate it via export:
firebase ext:export --mode functions --instance export-documents-testing \
  --kit-instance export-documents --project testing

# Repeat the export for production into the same kit instance to create
# .env.production from the export-documents-prod instance:
firebase ext:export --mode functions --instance export-documents-prod \
  --kit-instance export-documents --project production

Ahora tienes una sola instancia de kit configurada para implementarla en tus proyectos testing y production con sus respectivas configuraciones. Si creas una instancia en el proyecto testing y ejecutas el comando functions:kits:install para el mismo paquete en el proyecto production, se te solicitará la opción de reutilizar la instancia configurada para testing o instalar una segunda instancia.