Menjadwalkan ekspor data

Firebase CLI

1. Menginstal Firebase CLI Di direktori baru, lakukan inisialisasi CLI untuk Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Pilih JavaScript untuk bahasa.
   2. Jika ingin, aktifkan ESLint.
   3. Masukkan y untuk menginstal dependensi.

2. Ganti kode dalam file functions/index.js dengan yang berikut ini:

   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. Dalam kode di atas, ubah hal berikut ini:
   • Ganti BUCKET_NAME dengan nama bucket Anda.
   • Ubah every 24 hours untuk mengatur jadwal ekspor Anda. Gunakan sintaksis AppEngine cron.yaml atau format unix-cron (* * * * *).

   • Ubah collectionIds: [] untuk mengekspor grup koleksi yang ditentukan saja. Biarkan apa adanya untuk mengekspor semua koleksi.

4. Deploy fungsi yang dijadwalkan:

   firebase deploy --only functions

Konsol Google Cloud

Membuat Cloud Function

1. Buka halaman Cloud Functions di konsol Google Cloud.

   Buka Cloud Functions

2. Klik Create Function
3. Masukkan nama fungsi seperti firestoreExport
4. Pada Trigger, pilih Cloud Pub/Sub
5. Pada Topic, pilih Create new Topic. Masukkan nama untuk topik pub/sub, seperti initiateFirestoreExport. Catat nama topik karena Anda membutuhkannya untuk membuat tugas Cloud Scheduler.
6. Pada Source code, pilih Inline editor. Masukkan kode berikut di bagian 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);
       });
   };

   Pada kode di atas, ubah kode berikut:
   • Ganti BUCKET_NAME dengan nama bucket Anda.

   • Ubah collectionIds: [] untuk mengekspor grup koleksi yang ditentukan saja. Biarkan apa adanya untuk mengekspor semua koleksi.

7. Di bagian package.json, tambahkan dependensi berikut:

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

8. Di bagian Function to execute, masukkan scheduledFirestoreExport, nama fungsi dalam index.js.
9. Klik Create untuk men-deploy Cloud Function.

Membuat tugas Cloud Scheduler

Selanjutnya, buat tugas Cloud Scheduler yang memanggil Cloud Function Anda:

1. Buka halaman Cloud Scheduler di konsol Google Cloud.

   Buka Cloud Scheduler

2. Klik Create Job.
3. Masukkan nama di kolom Name untuk tugas seperti scheduledFirestoreExport.
4. Masukkan frekuensi waktu di kolom Frequency, misalnya every 24 hours.
5. Pilih zona waktu di Timezone.
6. Pada Target, pilih Pub/Sub. Pada kolom Topic, masukkan nama topik pub/sub yang Anda tetapkan di Cloud Function, initiateFirestoreExport dalam contoh di atas.
7. Pada kolom Payload, masukkan start export. Tugas membutuhkan penentuan payload, tetapi Cloud Function di atas tidak benar-benar menggunakan nilai ini.
8. Klik Create.

Firebase Console

Buka halaman Cloud Functions di Firebase console.

Buka Function Logs

GCP Console

Buka halaman Cloud Functions di konsol Google Cloud.

Buka Logs Viewer