管理遠端設定伺服器範本和版本管理

選取範本類型： 用戶端範本 伺服器範本


Remote Config 範本是為 Firebase 專案建立的 JSON 格式參數和條件集。伺服器範本會使用 Firebase Admin SDK 為伺服器執行個體提供設定 (適用於 Node.js、Java、Python 和 Go)。Remote Config

您可以使用 Firebase 控制台修改及管理伺服器範本。依序前往「DevOps & Engagement」 >「遠端設定」，在「參數」和「Conditions」頁面，以圖形格式查看範本內容。

以下是伺服器範本檔案的範例：

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

您可以在 Firebase 控制台中執行這些版本管理工作 (依序前往「DevOps & Engagement」 >「Remote Config」)：

  • 列出所有儲存的範本版本
  • 擷取特定版本
  • 復原至特定伺服器版本
  • 從「 變更記錄」頁面刪除 Remote Config 個範本。

每個範本類型最多可儲存 300 個版本 (300 個用戶端範本和 300 個伺服器範本)，包括已刪除範本的儲存版本號碼。如果專案生命週期內，每個範本類型發布超過 300 個範本版本，系統會刪除最早的版本，將該類型版本數量維持在最多 300 個。

每次更新參數時，Remote Config都會建立新的版本化Remote Config範本，並將先前的範本儲存為版本，方便您視需要擷取或復原。版本號碼會從 Remote Config 儲存的初始值開始，依序遞增。如圖所示，所有範本都包含 version 欄位，內含特定版本的中繼資料。

您可以在 Firebase 控制台的「DevOps & Engagement」>「遠端設定」>「變更記錄」頁面，視需要刪除 Remote Config 範本。

管理 Remote Config 範本版本

本節說明如何管理伺服器範本的Remote Config版本。

列出 Remote Config 範本的所有儲存版本

您可以擷取範本的所有儲存版本清單。Remote Config步驟如下：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 頁面。

  2. 選取右上方的「時鐘」圖示。

    「變更記錄」頁面隨即開啟，右側的清單選單會列出所有儲存的範本版本。

    範本清單會顯示所有儲存版本的相關中繼資料，包括更新時間、更新者和更新方式。

擷取特定版本的Remote Config範本

您可以擷取 Remote Config 範本的任何特定儲存版本。 如要擷取儲存的範本版本，請按照下列步驟操作：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 和參與度) >「Remote Config」(遠端設定) >「Change history」(變更記錄) 頁面。

  2. 根據預設，這個頁面會顯示目前使用的範本。如要查看其他版本，請在右側的詳細資料窗格中選取。

  3. 如要查看有效範本與任何其他儲存版本的詳細差異，請將游標懸停在任何未選取版本的內容選單上，然後選取「與所選版本比較」。

復原為特定儲存版本的 Remote Config 範本

您可以復原範本的任何儲存版本。如要復原範本，請按照下列步驟操作：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 和參與度) >「Remote Config」(遠端設定) >「Change history」(變更記錄) 頁面。

  2. 在頁面右上角找到選項按鈕，即可查看可還原的舊版範本。

  3. 請務必確認要復原至該版本，並為所有應用程式和使用者「立即」套用這些值，再點選並確認。

請注意，這項回溯作業實際上會建立新的編號版本。舉例來說，從版本 10 復原至版本 6，實際上會建立版本 6 的新副本，與原始版本唯一的差異在於版本號碼為 11。假設原始版本 6 尚未過期，系統仍會儲存該版本，並將版本 11 設為有效範本。

刪除 Remote Config 範本

您可以使用 Firebase 控制台刪除 Remote Config 範本。如要刪除範本，請按照下列步驟操作：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 頁面。

  2. 按一下 「變更記錄」。

  3. 切換至要刪除的範本，然後依序點按「更多」圖示 「刪除」。

  4. 系統提示確認刪除時，請按一下「刪除」。

下載及發布 Remote Config 範本

下載並發布 Remote Config 範本，將其整合至來源控制和建構系統、自動更新設定，並讓多個專案的參數和值保持同步。

您可以從 Firebase 控制台下載目前有效的 Remote Config 範本。接著，您可以更新匯出的 JSON 檔案，並發布至相同專案，或發布至新專案或現有專案。

舉例來說，假設您有多個專案代表軟體開發生命週期的不同階段，例如開發、測試、預備和正式環境。在這種情況下，您可以從測試專案下載經過完整測試的範本，然後發布至正式專案，將範本從測試環境升級至正式環境。

您也可以使用這個方法，將設定從一個專案遷移至另一個專案，或是從現有專案將參數和值填入新專案。

在 A/B Testing 實驗中專門建立為變數的參數和參數值，不會納入匯出的範本。

如要匯出及匯入 Remote Config 範本，請按照下列步驟操作：

  1. 下載目前的 Remote Config 範本。
  2. 驗證 Remote Config 範本。
  3. 發布Remote Config範本。

下載目前的 Remote Config 範本

如要以 JSON 格式下載有效 Remote Config 範本，請使用下列方法：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 或「Conditions」(條件) 頁面。

  2. 開啟「選單」，然後選取「下載目前的設定檔」。

  3. 系統提示時，請按一下「下載設定檔」，選擇要儲存檔案的位置，然後按一下「儲存」。

驗證 Remote Config 範本

嘗試從Firebase控制台發布時，系統會驗證伺服器範本。使用「隨機百分比中的使用者」規則的條件可以匯入，但如果條件不受支援，上傳時會產生錯誤。如果您嘗試發布的範本是從用戶端範本匯出，請務必先移除所有用戶端專屬條件。

發布「Remote Config」範本

下載範本、對 JSON 內容進行任何必要變更並驗證後，即可發布至專案。

發布範本時，系統會以更新後的檔案取代現有的整個設定範本，並將範本版本遞增 1。由於系統會取代整個設定，因此如果您從 JSON 檔案中刪除參數並發布，系統就會從伺服器刪除該參數，用戶端也無法再使用。

發布後，參數和值的變更會立即套用至應用程式和使用者。如有必要，可以復原至先前版本。

如要發布範本，請按照下列步驟操作：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 或「Conditions」(條件) 頁面。

  2. 開啟「選單」，然後選取「從檔案發布」。

  3. 出現提示時，按一下「瀏覽」，然後找出並選取要發布的 Remote Config 檔案，再按一下「選取」。

  4. 檔案已通過驗證。如果驗證成功，請按一下「發布」，讓應用程式和使用者立即使用這項設定。

後續步驟