جدولة عمليات تصدير البيانات

Firebase CLI

1. ثبِّت Firebase CLI. في دليل جديد، ابدأ CLI لـ Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. اختَر JavaScript للغة.
   2. يمكنك تفعيل ESLint اختياريًا.
   3. أدخِل y لتثبيت التبعيات.

2. استبدِل الرمز في الملف functions/index.js بالرمز التالي:

   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. في الرمز أعلاه، عدِّل ما يلي:
   • استبدِل BUCKET_NAME باسم الحزمة.
   • استبدِل YOUR_PROJECT_ID برقم تعريف مشروعك .
   • عدِّل every 24 hours لضبط جدول التصدير الزمني. استخدِم إما صيغة AppEngine cron.yaml أو الـ تنسيق unix-cron (* * * * *).

   • عدِّل collectionIds: [] لتصدير مجموعات قوائم التسوق المحدّدة فقط. اتركها كما هي لتصدير جميع مجموعات قوائم التسوق.

4. تفعيل الدالة المجدولة:

   firebase deploy --only functions

Google Cloud Console

إنشاء دالة على Cloud Function

1. انتقِل إلى صفحة Cloud Functions في Google Cloud Console:

   الانتقال إلى Cloud Functions

2. انقر على كتابة دالة
3. أدخِل اسم دالة، مثل firestore-export
4. ضِمن المشغِّل، اختَر Cloud Pub/Sub
5. ضِمن الموضوع ، اختَر إنشاء موضوع جديد. أدخِل اسمًا لموضوع Pub/Sub، مثل initiateFirestoreExport. سجِّل اسم الموضوع لأنّك ستحتاج إليه لإنشاء مهمة Cloud Scheduler.
6. ضمن رمز المصدر ، اختَر محرّر مضمّن. أدخِل الرمز التالي ضِمن 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(
       YOUR_PROJECT_ID,
       '(default)'
     );
   
     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);
       });
   };

   في الرمز أعلاه، عدِّل ما يلي:
   • استبدِل BUCKET_NAME باسم الحزمة.

   • عدِّل collectionIds: [] لتصدير مجموعات قوائم التسوق المحدّدة فقط. اتركها كما هي لتصدير جميع مجموعات قوائم التسوق.

7. ضِمن package.json، أضِف التبعية التالية:

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

8. ضِمن الدالة المطلوب تنفيذها، أدخِل scheduledFirestoreExport، وهو اسم الدالة في index.js.
9. انقر على إنشاء لنشر الدالة على Cloud Function.

إنشاء مهمة Cloud Scheduler

بعد ذلك، أنشِئ مهمة على Cloud Scheduler تستدعي الدالة على Cloud Function:

1. انتقِل إلى صفحة Cloud Scheduler في Google Cloud Console:

   الانتقال إلى Cloud Scheduler

2. انقر على إنشاء مهمة.
3. أدخِل اسمًا للمهمة، مثل scheduledFirestoreExport.
4. أدخِل تكرارًا، مثلاً every 24 hours.
5. اختَر منطقة زمنية.
6. ضِمن الهدف ، اختَر Pub/Sub. في حقل الموضوع، أدخِل اسم موضوع Pub/Sub الذي حدّدته بجانب الدالة على Cloud Function، initiateFirestoreExport في المثال أعلاه.
7. في حقل الحمولة ، أدخِل start export. تتطلّب المهمة حمولة محدّدة، ولكن الدالة على Cloud Function أعلاه لا تستخدم هذه القيمة فعليًا.
8. انقر على إنشاء.