Programa exportaciones de datos

Firebase CLI

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

   firebase init functions --project PROJECT_ID

   1. Selecciona el lenguaje JavaScript.
   2. Opcionalmente, habilita ESLint.
   3. Ingresa y para instalar las dependencias.

2. Reemplaza el código del archivo functions/index.js con lo 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:
   • Reemplaza BUCKET_NAME por el nombre de tu bucket.
   • Modifica every 24 hours para establecer tu programa de exportación. Utiliza la sintaxis cron.yaml de App Engine o el formato unix-cron (* * * * *).

   • Modifica collectionIds: [] para que solo se exporten los grupos de colecciones especificados. No lo modifiques si quieres exportar todas las colecciones.

4. Implementa la función programada con este comando:

   firebase deploy --only functions

Consola de Google Cloud

Crea una Cloud Function

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

   Ir a Cloud Functions

2. Haz clic en Crear función.
3. Ingresa un nombre de función, como firestoreExport
4. En Activador, selecciona Cloud Pub/Sub.
5. En Tema, selecciona Crear tema nuevo. Ingresa un nombre para el tema de Pub/Sub, como initiateFirestoreExport. Anota el nombre del tema, ya que lo necesitarás para crear tu trabajo de Cloud Scheduler.
6. En Código fuente, selecciona Editor directo. Ingresa 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(
       process.env.GCP_PROJECT,
       '(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, modifica lo siguiente:
   • Reemplaza BUCKET_NAME por el nombre de tu bucket.

   • Modifica collectionIds: [] para que solo se exporten los grupos de colecciones especificados. No lo modifiques si quieres exportar todas las colecciones.

7. En package.json, agrega la siguiente dependencia:

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

8. En Función que se ejecutará, ingresa scheduledFirestoreExport, el nombre de la función de index.js.
9. Haz clic en Crear para implementar la Cloud Function.

Crea un trabajo de Cloud Scheduler

A continuación, crea un trabajo de Cloud Scheduler que llame a tu Cloud Function:

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

   Ir a Cloud Scheduler

2. Haz clic en Crear trabajo.
3. Ingresa un Nombre para el trabajo, como scheduledFirestoreExport.
4. Ingresa una Frecuencia, como every 24 hours.
5. Selecciona una Zona horaria.
6. En Destino, selecciona Pub/Sub. En el campo Tema, ingresa el nombre del tema de Pub/Sub que definiste junto con tu función de Cloud Functions, initiateFirestoreExport, en el ejemplo anterior.
7. En el campo Carga útil, ingresa start export. El trabajo requiere que se defina una carga útil, pero la Cloud Function anterior no utiliza realmente este valor.
8. Haz clic en Crear.

Firebase console

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

Ir a Registros de funciones

GCP Console

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

Ir al Visor de registros