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

Firebase CLI

1. ثبِّت واجهة سطر الأوامر في Firebase. في دليل جديد، ابدأ في تهيئة واجهة سطر الأوامر 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 باسم حزمة التخزين.
   • يُرجى تعديل "every 24 hours" لضبط الجدول الزمني للتصدير. استخدام أيّ منهما بنية AppEngine cron.yaml أو تنسيق يونكس كرون (* * * * *).

   • تعديل collectionIds: [] لتصدير ما هو محدّد فقط مجموعات أخرى. يمكنك تركها كما هي لتصدير جميع المجموعات.

4. نشر الدالة المُجدوَلة:

   firebase deploy --only functions

وحدة تحكُّم Google Cloud

إنشاء دالة سحابية

1. انتقِل إلى صفحة وظائف Cloud في وحدة التحكّم في Google Cloud:

   الانتقال إلى وظائف السحابة الإلكترونية

2. انقر على إنشاء دالة.
3. أدخِل اسم دالة مثل firestoreExport.
4. ضمن المشغّل، اختَر Cloud Pub/Sub.
5. ضمن الموضوع، اختَر إنشاء موضوع جديد. يُرجى إدخال اسم موضوع الناشر/الفرعي، مثل 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(
       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);
       });
   };

   في الرمز البرمجي أعلاه، عدِّل ما يلي:
   • استبدِل 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. ضمن الاستهداف، اختَر نشر/اشتراك. في الحقل الموضوع، أدخل اسم موضوع الناشر/الفرع الذي حددته بجانب دالة السحابة الإلكترونية، initiateFirestoreExport في المثال أعلاه.
7. في الحقل حمولة، أدخِل start export. تتطلّب الوظيفة تحديد حمولة، ولكن دالة Cloud Function أعلاه لا تستخدم هذه القيمة في الواقع.
8. انقر على إنشاء.

وحدة تحكُّم Firebase

انتقِل إلى صفحة Cloud Functions في "وحدة تحكُّم Firebase".

الانتقال إلى سجلّات الدوال

وحدة تحكّم Google Cloud Platform

انتقِل إلى صفحة Cloud Functions في وحدة التحكّم في Google Cloud.

الانتقال إلى Logs Viewer (عارض السجلات)