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

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

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.

إنشاء وظيفة Cloud Scheduler

بعد ذلك، أنشِئ وظيفة على Cloud Scheduler تستدعي الدالة على Cloud:

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

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

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