Planowanie eksportu danych

wiersz poleceń Firebase

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

   firebase init functions --project PROJECT_ID

   1. Wybierz język JavaScript.
   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.
   • Zastąp YOUR_PROJECT_ID identyfikatorem projektu.
   • Zmodyfikuj every 24 hours, aby ustawić harmonogram eksportu. Użyj składni pliku cron.yaml App Engine lub formatu unix-cron (* * * * *).

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

4. Wdróż zaplanowaną funkcję:

   firebase deploy --only functions

Konsola Google Cloud

Utwórz funkcję w Cloud Functions

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

   Otwórz Cloud Functions

2. Kliknij Napisz funkcję.
3. Wpisz nazwę funkcji, np. firestore-export.
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) => {
     // Access the GCLOUD_PROJECT environment variable set by the runtime.
     const projectId =
       process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT;
     // Use the DATABASE_ID environment variable if set,
     // otherwise default to '(default)'
     const databaseId = process.env.DATABASE_ID || '(default)';
     const databaseName = client.databasePath(
       projectId,
       databaseId
     );
   
     return client
       .exportDocuments({
         name: databaseName,
         outputUriPrefix: bucket,
         // Leave collectionIds empty to export all collection groups
         // or define a list of collection group 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 collectionIds: [], aby wyeksportować tylko określone grupy kolekcji. Pozostaw to pole bez zmian, aby wyeksportować wszystkie grupy kolekcji.

   • (Opcjonalnie) Jeśli używasz niestandardowej bazy danych, podczas tworzenia funkcji Cloud ustaw zmienną środowiskową DATABASE_ID. Jeśli używasz środowiska wykonawczego, w którym zmienna GOOGLE_CLOUD_PROJECT nie jest ustawiana automatycznie, możesz też ustawić ją ręcznie lub zastąpić ją w kodzie identyfikatorem projektu.

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: 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, czyli initiateFirestoreExport w poprzednim przykładzie.
7. W polu Payload (Ładunek) wpisz start export. Zadanie wymaga zdefiniowania ładunku, ale poprzedzająca je funkcja w Cloud Functions nie używa tej wartości.
8. Kliknij Utwórz.