На этой странице описано, как запланировать экспорт данных из Cloud Firestore . Для запуска экспорта по расписанию мы рекомендуем использовать Cloud Functions и Cloud Scheduler .
Прежде чем начать
Перед планированием экспорта управляемых данных необходимо выполнить следующие задачи:
- Включите оплату для вашего проекта Google Cloud . Только проекты Google Cloud с включенной оплатой могут использовать функцию экспорта и импорта.
- Для операций экспорта требуется целевой сегмент Cloud Storage . Создайте сегмент Cloud Storage в месте, близком к местоположению вашей базы данных Cloud Firestore . Вы не можете использовать сегмент Requester Pays для операций экспорта.
Создайте облачную функцию и задание Cloud Scheduler .
Выполните следующие шаги, чтобы создать облачную функцию Node.js, которая инициирует экспорт данных в Cloud Firestore , и задание Cloud Scheduler для вызова этой функции:
Firebase CLI
Установите Firebase CLI . В новой директории инициализируйте CLI для Cloud Functions :
firebase init functions --project PROJECT_ID
- Выберите JavaScript в качестве языка.
- При желании можно включить ESLint.
- Введите
yдля установки зависимостей.
Замените код в файле
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'); }); });
- В приведенном выше коде внесите следующие изменения:
- Замените
BUCKET_NAMEна имя вашего хранилища (bucket). - Замените
YOUR_PROJECT_IDна идентификатор вашего проекта. - Для настройки расписания экспорта изменяйте его
every 24 hours. Используйте либо синтаксис cron.yaml в AppEngine , либо формат unix-cron (* * * * *). Измените
collectionIds: [], чтобы экспортировать только указанные группы коллекций. Оставьте как есть, чтобы экспортировать все группы коллекций.
- Замените
Разверните запланированную функцию:
firebase deploy --only functions
Консоль Google Cloud
Создайте облачную функцию
Перейдите на страницу Cloud Functions в консоли Google Cloud:
- Нажмите «Написать функцию».
- Введите имя функции, например,
firestore-export - В разделе «Триггер» выберите Cloud Pub/Sub.
- В разделе «Тема» выберите «Создать новую тему» . Введите имя для темы публикации/подписки, например,
initiateFirestoreExport. Запишите имя темы, так как оно понадобится для создания задания Cloud Scheduler . - Under Source code , select Inline editor . Enter the following code under
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на имя вашего хранилища (bucket). Измените
collectionIds: [], чтобы экспортировать только указанные группы коллекций. Оставьте как есть, чтобы экспортировать все группы коллекций.
- Замените
- В файле
package.jsonдобавьте следующую зависимость:{ "dependencies": { "@google-cloud/firestore": "^1.3.0" } } - В поле «Функция для выполнения» введите
scheduledFirestoreExport— имя функции изindex.js. - Нажмите «Создать» , чтобы развернуть облачную функцию.
Создайте задание Cloud Scheduler .
Далее создайте задание Cloud Scheduler , которое будет вызывать вашу облачную функцию:
Перейдите на страницу Cloud Scheduler в консоли Google Cloud:
- Нажмите «Создать задание» .
- Введите название для задания, например,
scheduledFirestoreExport. - Укажите частоту , например,
every 24 hours. - Выберите часовой пояс .
- В разделе «Цель» выберите «Pub/Sub» . В поле «Тема» введите имя темы pub/sub, которую вы определили вместе с вашей облачной функцией, например,
initiateFirestoreExportкак в примере выше. - В поле «Полезная нагрузка» введите
start export. Для выполнения задания требуется определенная полезная нагрузка, но описанная выше облачная функция фактически не использует это значение. - Нажмите «Создать» .
Настройте права доступа.
Далее предоставьте облачной функции разрешение на запуск операций экспорта и запись в ваш сегмент GCS.
Эта облачная функция использует учетную запись службы по умолчанию вашего проекта для аутентификации и авторизации операций экспорта. При создании проекта для вас создается учетная запись службы по умолчанию со следующим именем:
PROJECT_ID@appspot.gserviceaccount.com
Этой учетной записи службы требуются разрешения на запуск операции экспорта и запись в ваш сегмент Cloud Storage . Чтобы предоставить эти разрешения, назначьте следующие роли IAM учетной записи службы по умолчанию:
-
Cloud Datastore Import Export Admin - Роль
OwnerилиStorage Adminдля корзины
You can use the gcloud and gsutil command-line tools to assign these roles.
Если эти инструменты еще не установлены, вы можете получить к ним доступ через Cloud Shell в консоли Google Cloud:
Запустить Cloud Shell
Назначьте роль администратора импорта и экспорта облачного хранилища данных . Замените PROJECT_ID и выполните следующую команду:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member serviceAccount:PROJECT_ID@appspot.gserviceaccount.com \ --role roles/datastore.importExportAdmin
Назначьте вашему сегменту роль администратора хранилища . Замените PROJECT_ID и BUCKET_NAME и выполните следующую команду:
gsutil iam ch serviceAccount:PROJECT_ID@appspot.gserviceaccount.com:admin \ gs://BUCKET_NAME
Если вы отключите или удалите свою учетную запись службы App Engine по умолчанию, ваше приложение App Engine потеряет доступ к базе данных Cloud Firestore . Если вы отключили учетную запись службы App Engine , вы можете повторно включить ее (см. раздел « Включение учетной записи службы» ). Если вы удалили учетную запись службы App Engine в течение последних 30 дней, вы можете восстановить ее (см. раздел «Восстановление удаленной учетной записи службы») .
Протестируйте задание Cloud Scheduler и облачную функцию.
Вы можете протестировать свою задачу Cloud Scheduler на странице Cloud Scheduler в консоли Google Cloud.
Перейдите на страницу Cloud Scheduler в консоли Google Cloud.
Перейдите в Cloud SchedulerВ строке для нового задания Cloud Scheduler нажмите «Запустить сейчас» .
After a few seconds, the Cloud Scheduler job should update the result column to Success and Last run to the current time. You may need to click Refresh .
На странице « Cloud Scheduler подтверждается только факт вызова вашей облачной функции. Чтобы просмотреть журналы вашей функции, откройте страницу «Облачная функция».
Просмотрите журналы облачных функций.
To see if the Cloud Function successfully started an export operation, open the function's logs:
Консоль Firebase
In the Firebase console, go to Hosting & Serverless > Functions .
Консоль GCP
Go to the Cloud Functions page in the Google Cloud console.
Отслеживание хода экспорта
You can use the gcloud firestore operations list command to view the progress of your export operations, see managing export and import operations .
After an export operation completes, you can view the output files in your Cloud Storage bucket:
Откройте браузер Cloud Storage .