Programar exportaciones de datos

CLI de Firebase

1. Instala la CLI de Firebase. En un directorio nuevo, inicializa la CLI para Cloud Run Functions:

   firebase init functions --project PROJECT_ID

   1. Selecciona JavaScript como idioma.
   2. Opcionalmente, habilita ESLint.
   3. Introduce y para instalar las dependencias.

2. Sustituye el código del archivo functions/index.js por el siguiente:

   const functions = require('firebase-functions');
   const firestore = require('@google-cloud/firestore');
   const client = new firestore.v1.FirestoreAdminClient();
   
   // Replace BUCKET_NAME
   const bucket = 'gs://BUCKET_NAME';
   
   exports.scheduledFirestoreExport = functions.pubsub
                                               .schedule('every 24 hours')
                                               .onRun((context) => {
   
     const projectId = process.env.GCP_PROJECT;
     const databaseName = 
       client.databasePath(projectId, '(default)');
   
     return client.exportDocuments({
       name: databaseName,
       outputUriPrefix: bucket,
       // Leave collectionIds empty to export all collections
       // or set to a list of collection IDs to export,
       // collectionIds: ['users', 'posts']
       collectionIds: []
       })
     .then(responses => {
       const response = responses[0];
       console.log(`Operation Name: ${response['name']}`);
     })
     .catch(err => {
       console.error(err);
       throw new Error('Export operation failed');
     });
   });
   index.js

3. En el código anterior, modifica lo siguiente:
   • Sustituye BUCKET_NAME por el nombre de tu segmento.
   • Sustituye YOUR_PROJECT_ID por el ID de tu proyecto.
   • Modifica every 24 hours para definir la programación de exportación. Usa la sintaxis cron.yaml de App Engine o el formato cron de UNIX (* * * * *).

   • Modifica collectionIds: [] para exportar solo los grupos de colecciones especificados. Déjalo como está para exportar todas las colecciones.

4. Despliega la función programada:

   firebase deploy --only functions

Google Cloud consola

Crea un rol de Cloud Functions

1. Ve a la página Cloud Functions de la consola de Google Cloud :

   Ir a Cloud Functions

2. Haz clic en Escribir una función.
3. Introduce un nombre de función, como firestore-export.
4. En Activador, selecciona Cloud Pub/Sub.
5. En Tema, selecciona Crear tema. Introduce un nombre para el tema de Pub/Sub, como initiateFirestoreExport. Anota el nombre del tema, ya que lo necesitarás para crear tu tarea de Cloud Scheduler.
6. En Código fuente, selecciona Editor insertado. Introduce el siguiente código en index.js:

   const firestore = require('@google-cloud/firestore');
   const client = new firestore.v1.FirestoreAdminClient();
   // Replace BUCKET_NAME
   const bucket = 'gs://BUCKET_NAME'
   
   exports.scheduledFirestoreExport = (event, context) => {
     const databaseName = client.databasePath(
       YOUR_PROJECT_ID,
       '(default)'
     );
   
     return client
       .exportDocuments({
         name: databaseName,
         outputUriPrefix: bucket,
         // Leave collectionIds empty to export all collections
         // or define a list of collection IDs:
         // collectionIds: ['users', 'posts']
         collectionIds: [],
       })
       .then(responses => {
         const response = responses[0];
         console.log(`Operation Name: ${response['name']}`);
         return response;
       })
       .catch(err => {
         console.error(err);
       });
   };

   En el código anterior, modifique lo siguiente:
   • Sustituye BUCKET_NAME por el nombre de tu segmento.

   • Modifica collectionIds: [] para exportar solo los grupos de colecciones especificados. Déjalo como está para exportar todas las colecciones.

7. En package.json, añade la siguiente dependencia:

   {
     "dependencies": {
       "@google-cloud/firestore": "^1.3.0"
     }
   }

8. En Función que se va a ejecutar, introduce scheduledFirestoreExport, el nombre de la función en index.js.
9. Haz clic en Crear para desplegar la función de Cloud Functions.

Crear una tarea de Cloud Scheduler

A continuación, crea una tarea de Cloud Scheduler que llame a tu función de Cloud:

1. Ve a la página Cloud Scheduler de la consola de Google Cloud :

   Ir a Cloud Scheduler

2. Haz clic en Crear trabajo.
3. Introduce un nombre para el trabajo, como scheduledFirestoreExport.
4. Introduce una frecuencia; por ejemplo, every 24 hours.
5. Selecciona una zona horaria.
6. En Destino, selecciona Pub/Sub. En el campo Tema, introduce el nombre del tema de publicación/suscripción que hayas definido junto con tu función de Cloud, initiateFirestoreExport en el ejemplo anterior.
7. En el campo Carga útil, introduce start export. El trabajo requiere una carga útil definida, pero la función de Cloud anterior no usa este valor.
8. Haz clic en Crear.

Consola de Firebase

Ve a la página Funciones de Cloud Run de la consola de Firebase.

Ir a Registros de funciones

Consola de GCP

Ve a la página Funciones de Cloud Run de la Google Cloud consola.

Ir al visualizador de registros