Planowanie eksportu danych

wiersz poleceń Firebase

1. Zainstaluj wiersz poleceń Firebase. W nowym katalogu zainicjuj interfejs wiersza poleceń dla Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Wybierz JavaScript jako język.
   2. Opcjonalnie włącz ESLint.
   3. Wpisz y, aby zainstalować zależności.

2. Zastąp kod w pliku functions/index.js tym kodem:

   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. W powyższym kodzie zmień te elementy:
   • Zastąp BUCKET_NAME nazwą zasobnika.
   • Zmodyfikuj every 24 hours, aby ustawić harmonogram eksportu. Użyj składni pliku cron.yaml App Engine lub formatu unix-cron (* * * * *).

   • Zmodyfikuj wartość collectionIds: [], aby wyeksportować tylko określone grupy kolekcji. Aby wyeksportować wszystkie kolekcje, pozostaw to pole bez zmian.

4. Wdróż zaplanowaną funkcję:

   firebase deploy --only functions

Google Cloud Console

Utwórz funkcję w Cloud Functions

1. Otwórz stronę Cloud Functions w konsoli Google Cloud:

   Otwórz Cloud Functions

2. Kliknij Utwórz funkcję.
3. Wpisz nazwę funkcji, np. firestoreExport.
4. W sekcji Aktywator wybierz Cloud Pub/Sub.
5. W sekcji Temat wybierz Utwórz nowy temat. Wpisz nazwę tematu Pub/Sub, np. initiateFirestoreExport. Zanotuj nazwę tematu, ponieważ będzie Ci potrzebna do utworzenia zadania Cloud Scheduler.
6. W sekcji Kod źródłowy wybierz Edytor wbudowany. Wpisz ten kod w sekcji 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);
       });
   };

   W powyższym kodzie zmień te elementy:
   • Zastąp BUCKET_NAME nazwą zasobnika.

   • Zmodyfikuj wartość collectionIds: [], aby wyeksportować tylko określone grupy kolekcji. Aby wyeksportować wszystkie kolekcje, pozostaw to pole bez zmian.

7. W sekcji package.json dodaj tę zależność:

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

8. W polu Funkcja do wykonania wpisz scheduledFirestoreExport, czyli nazwę funkcji w index.js.
9. Aby wdrożyć funkcję Cloud, kliknij Utwórz.

Tworzenie zadania Cloud Scheduler

Następnie utwórz zadanie Cloud Scheduler, które wywołuje funkcję w Cloud Functions:

1. W konsoli Google Cloud otwórz stronę Cloud Scheduler:

   Otwórz stronę Cloud Scheduler

2. Kliknij Utwórz zadanie.
3. Wpisz nazwę zadania, np. scheduledFirestoreExport.
4. Wpisz częstotliwość, np. every 24 hours.
5. Wybierz strefę czasową.
6. W sekcji Miejsce docelowe wybierz Pub/Sub. W polu Temat wpisz nazwę tematu Pub/Sub zdefiniowanego razem z funkcją w Cloud Functions, initiateFirestoreExport jak w przykładzie powyżej.
7. W polu Payload (Ładunek) wpisz start export. Zadanie wymaga zdefiniowania ładunku, ale powyższa funkcja w Cloud Functions nie używa tej wartości.
8. Kliknij Utwórz.

Konsola Firebase

W konsoli Firebase otwórz stronę Cloud Functions.

Otwórz logi funkcji

konsola GCP

W konsoli Google Cloud otwórz stronę Cloud Functions.

Otwórz przeglądarkę logów