Pianificare le esportazioni di dati

interfaccia a riga di comando di Firebase

1. Installa l'interfaccia a riga di comando di Firebase. In una nuova directory, inizializza l'interfaccia a riga di comando per le funzioni Cloud Run:

   firebase init functions --project PROJECT_ID

   1. Seleziona JavaScript per la lingua.
   2. Se vuoi, attiva ESLint.
   3. Inserisci y per installare le dipendenze.

2. Sostituisci il codice nel file functions/index.js con quanto segue:

   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. Nel codice precedente, modifica quanto segue:
   • Sostituisci BUCKET_NAME con il nome del bucket.
   • Modifica every 24 hours per impostare la pianificazione dell'esportazione. Utilizza la sintassi cron.yaml di App Engine o il formato unix-cron (* * * * *).

   • Modifica collectionIds: [] per esportare solo i gruppi di raccolte specificati. Lascia invariato per esportare tutte le raccolte.

4. Esegui il deployment della funzione pianificata:

   firebase deploy --only functions

Console Google Cloud

Crea una funzione Cloud

1. Vai alla pagina Cloud Functions nella console Google Cloud:

   Vai a Cloud Functions

2. Fai clic su Crea funzione
3. Inserisci un nome funzione, ad esempio firestoreExport
4. In Trigger, seleziona Cloud Pub/Sub.
5. Nella sezione Argomento, seleziona Crea nuovo argomento. Inserisci un nome per l'argomento Pub/Sub, ad esempio initiateFirestoreExport. Prendi nota del nome dell'argomento, poiché lo dovrai utilizzare per creare il job Cloud Scheduler.
6. In Codice sorgente, seleziona Editor incorporato. Inserisci il seguente codice in 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);
       });
   };

   Nel codice riportato sopra, modifica quanto segue:
   • Sostituisci BUCKET_NAME con il nome del bucket.

   • Modifica collectionIds: [] per esportare solo i gruppi di raccolte specificati. Lascia invariato per esportare tutte le raccolte.

7. In package.json, aggiungi la seguente dipendenza:

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

8. In Funzione da eseguire, inserisci scheduledFirestoreExport, il nome della funzione in index.js.
9. Fai clic su Crea per eseguire il deployment della Cloud Function.

Crea un job Cloud Scheduler

A questo punto, crea un job Cloud Scheduler che chiami la tua Cloud Function:

1. Vai alla pagina Cloud Scheduler nella console Google Cloud:

   Vai a Cloud Scheduler

2. Fai clic su Crea job.
3. Inserisci un Nome per il job, ad esempio scheduledFirestoreExport.
4. Inserisci una frequenza, ad esempio every 24 hours.
5. Seleziona un Fuso orario.
6. In Destinazione, seleziona Pub/Sub. Nel campo Topic, inserisci il nome dell'argomento Pub/Sub che hai definito insieme alla funzione Cloud, initiateFirestoreExport nell'esempio precedente.
7. Nel campo Payload, inserisci start export. Il job richiede un payload definito, ma la Cloud Function sopra riportata non utilizza effettivamente questo valore.
8. Fai clic su Crea.

Console Firebase

Vai alla pagina Funzioni Cloud Run nella Console Firebase.

Vai a Log delle funzioni

Console di GCP

Vai alla pagina Funzioni Cloud Run nella console Google Cloud.

Vai al visualizzatore log