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

Firebase CLI

1. ثبِّت واجهة سطر الأوامر في Firebase. في دليل جديد، ابدأ في تهيئة واجهة سطر الأوامر وظائف السحابة الإلكترونية:

   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 Platform

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

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

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

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. انتقِل إلى صفحة أداة جدولة في السحابة الإلكترونية في وحدة تحكُّم Google Cloud Platform:

   الانتقال إلى "أداة جدولة المهام في السحابة الإلكترونية"

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

وحدة تحكُّم Firebase

انتقِل إلى صفحة وظائف السحابة الإلكترونية في وحدة تحكُّم Firebase.

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

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

انتقِل إلى صفحة وظائف السحابة الإلكترونية في وحدة تحكُّم Google Cloud Platform.

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