Запланировать экспорт данных

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 на имя вашего хранилища (bucket).
   • Замените YOUR_PROJECT_ID на идентификатор вашего проекта.
   • Для настройки расписания экспорта изменяйте его every 24 hours . Используйте либо синтаксис cron.yaml в AppEngine , либо формат unix-cron ( * * * * * ).

   • Измените collectionIds: [] , чтобы экспортировать только указанные группы коллекций. Оставьте как есть, чтобы экспортировать все группы коллекций.

4. Разверните запланированную функцию:

   firebase deploy --only functions

Консоль Google Cloud

Создайте облачную функцию

1. Перейдите на страницу Cloud Functions в консоли Google Cloud:

   Перейдите в раздел «Облачные функции».

2. Нажмите «Написать функцию».
3. Введите имя функции, например, firestore-export
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) => {
     // Access the GCLOUD_PROJECT environment variable set by the runtime.
     const projectId =
       process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT;
     // Use the DATABASE_ID environment variable if set,
     // otherwise default to '(default)'
     const databaseId = process.env.DATABASE_ID || '(default)';
     const databaseName = client.databasePath(
       projectId,
       databaseId
     );
   
     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 на имя вашего хранилища (bucket).

   • Измените collectionIds: [] , чтобы экспортировать только указанные группы коллекций. Оставьте как есть, чтобы экспортировать все группы коллекций.

   • (Необязательно) Если вы используете нестандартную базу данных, убедитесь, что вы установили переменную среды DATABASE_ID при создании облачной функции. Если вы используете среду выполнения, в которой переменная GOOGLE_CLOUD_PROJECT не устанавливается автоматически, вам также может потребоваться установить ее вручную или заменить ее идентификатором вашего проекта в коде.

7. В файле package.json добавьте следующую зависимость:

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

8. В поле «Функция для выполнения» введите scheduledFirestoreExport — имя функции из index.js .
9. Нажмите «Создать» , чтобы развернуть облачную функцию.

Создайте задание Cloud Scheduler .

Далее создайте задание Cloud Scheduler , которое будет вызывать вашу облачную функцию:

1. Перейдите на страницу Cloud Scheduler в консоли Google Cloud:

   Перейдите в Cloud Scheduler

2. Нажмите «Создать задание» .
3. Введите название для задания, например, scheduledFirestoreExport .
4. Укажите частоту , например, every 24 hours .
5. Выберите часовой пояс .
6. В разделе «Цель» выберите «Pub/Sub» . В поле «Тема» введите имя темы pub/sub, которую вы определили вместе с вашей облачной функцией, например, initiateFirestoreExport как в предыдущем примере.
7. В поле «Полезная нагрузка» введите start export . Для выполнения задания требуется определенная полезная нагрузка, но предыдущая облачная функция фактически не использует это значение.
8. Нажмите «Создать» .