排定資料匯出作業

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 替換為 Cloud Storage 也提供目錄同步處理功能 方便您同步處理 VM 目錄與值區
   • 修改 every 24 hours，設定匯出時間表。請擇一使用 AppEngine cron.yaml 語法或 unix-cron 格式 (* * * * *)。

   • 修改 collectionIds: []，僅匯出指定的 產品素材資源集合群組。請保持原樣，匯出所有集合。

4. 部署排定的函式：

   firebase deploy --only functions

GCP 控制台

建立 Cloud 函式

1. 前往 GCP Console 的「Cloud Functions」頁面：

   前往「Cloud Functions」頁面

2. 按一下「建立函式」
3. 請輸入函式名稱，例如 firestoreExport
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(
       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 替換為 Cloud Storage 也提供目錄同步處理功能 方便您同步處理 VM 目錄與值區

   • 修改 collectionIds: []，僅匯出指定的 產品素材資源集合群組。請保持原樣，匯出所有集合。

7. 在 package.json 下方，新增下列依附元件：

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

8. 在「Function to run」(要執行的函式) 下方，輸入 scheduledFirestoreExport， index.js 中的函式名稱。
9. 按一下「建立」來部署 Cloud 函式。

建立 Cloud Scheduler 工作

接著，建立 Cloud Scheduler 工作來呼叫 Cloud 函式：

1. 前往 GCP Console 中的「Cloud Scheduler」頁面：

   前往 Cloud Scheduler

2. 按一下 [Create Job] (建立工作)。
3. 輸入工作的「Name」(名稱)，例如 scheduledFirestoreExport。
4. 輸入「頻率」，例如 every 24 hours。
5. 選取時區。
6. 在「Target」下方，選取「Pub/Sub」。在「Topic」欄位中 請輸入您在 Cloud 函式，範例中的 initiateFirestoreExport 。
7. 在「Payload」欄位中輸入 start export。 工作需要定義酬載，但上述 Cloud 函式會 其實並未使用 值。
8. 按一下「建立」。

Firebase 主控台

前往 Firebase 控制台的「Cloud Functions」頁面。

前往函式記錄檔頁面

GCP 控制台

前往 GCP 主控台的「Cloud Functions」頁面。

前往記錄檢視器