遠端設定範本和版本管理


Remote Config 範本是您為 Firebase 專案建立的 JSON 格式參數和條件集。您可以建立用戶端範本 (應用程式會從中擷取值),以及伺服器範本 (伺服器用戶端會從中擷取值)。

本節將討論伺服器範本。如要瞭解特定用戶端的範本,請按一下「用戶端範本」

您可以使用 Firebase 控制台修改及管理範本,控制台會在「參數」和「條件」分頁中,以圖形格式顯示範本內容。

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

{
  "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 控制台執行下列版本管理工作:

  • 列出所有儲存的範本版本
  • 擷取特定版本
  • 復原至特定用戶端版本
  • 從「變更記錄」頁面刪除 Remote Config 範本

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

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

您可以視需要從 Remote Config 控制台的「變更記錄」頁面刪除 Remote Config 範本。

管理 Remote Config 範本版本

本節說明如何管理Remote Config範本版本。

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

您可以擷取 Remote Config 範本的所有儲存版本清單。現在說明一下操作方式:

  1. Firebase 控制台開啟 Remote Config

  2. 然後在「參數」分頁中,選取右上方的「時鐘」圖示。

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

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

擷取特定版本的 Remote Config 範本

您可以擷取 Remote Config 範本的任何特定儲存版本。如要擷取儲存的範本版本:

  1. 開啟「變更記錄」的詳細資料窗格。

  2. 如要查看清單中其他版本的詳細資料,請從右側選單中選取。

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

還原至 Remote Config 範本的特定儲存版本

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

  1. 在「變更記錄」頁面右上角找到選項按鈕。只有在確定要還原至該版本,並立即將這些值套用至所有應用程式和使用者時,才點選並確認。

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

刪除 Remote Config 範本

您可以從 Firebase 控制台刪除 Remote Config 範本。如要刪除 Remote Config 範本,請按照下列步驟操作:

1. 在「參數」Remote Config 頁面中,按一下 「變更記錄」
  1. 切換至要刪除的範本,按一下「更多」圖示 ,然後選取「刪除」

  2. 系統提示確認刪除時,請按一下「刪除」

下載及發布 Remote Config 範本

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

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

假設您有多個專案,分別代表軟體開發生命週期的不同階段,例如開發、測試、試行和實際工作環境。在這種情況下,您可以從暫存專案下載經過完整測試的範本,然後發布至實際工作專案,將範本從暫存環境升級至實際工作環境。

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

A/B Testing 實驗中專門建立為變體的參數和參數值,不會匯出至範本。

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

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

下載目前的遠端設定範本

使用下列項目下載 JSON 格式的有效 Remote Config 範本:

  1. 在「Parameters」或「Conditions」Remote Config分頁中,開啟「Menu」,然後選取「Download current config file」
  2. 系統提示時,請按一下「下載設定檔」,選擇要儲存檔案的位置,然後按一下「儲存」

驗證遠端設定範本

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

發布 Remote Config 範本

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

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

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

請使用下列指令發布範本:

  1. 在「參數」或「條件」Remote Config分頁中,開啟「選單」,然後選取「從檔案發布」
  2. 出現提示時,按一下「瀏覽」,然後前往並選取要發布的 Remote Config 檔案,再按一下「選取」
  3. 系統會驗證檔案,如果驗證成功,您可以按一下「發布」,讓應用程式和使用者立即使用設定。

後續步驟