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

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


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

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

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

{
  "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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

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

每種範本類型 (用戶端範本和伺服器範本各 300 個) 的永久儲存版本總數上限為 300 個，包括已刪除範本的儲存版本數量。如果在專案生命週期內，每種範本類型發布超過 300 個範本版本，系統會刪除最早的版本，最多保留 300 個該類型的版本。

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

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

管理 Remote Config 個範本版本

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

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

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

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

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

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

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

擷取特定版本的 Remote Config 範本

您可以擷取任何儲存的特定 Remote Config 範本版本。以下說明如何擷取儲存的範本版本：

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

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

  3. 如要查看使用中範本與其他儲存版本的詳細差異，請將滑鼠游標懸停在任何未選取版本的內容選單上，然後選取「Compare with selected version」(與所選版本比較)。

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

您可以復原為任何已儲存的範本版本。復原範本的方法如下：

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

  2. 在頁面右上方，找出可復原的舊版範本選項按鈕。

  3. 只有在確定要復原至該版本，並立即為所有應用程式和使用者套用這些值時，才點選並確認這項操作。

請注意，這項復原作業實際上會建立新的編號版本。舉例來說，從第 10 版復原至第 6 版，實際上會建立第 6 版的新副本，與原始版本的唯一差異在於版本編號為 11。假設原始版本 6 尚未到期，則仍會儲存，而版本 11 則會成為使用中的範本。

刪除Remote Config範本

您可以使用 Firebase 控制台刪除 Remote Config 範本。刪除範本的方法如下：

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

  2. 按一下 「Change history」(變更記錄)。

  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」 >「遠端設定」 >「參數或條件」頁面。

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

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

驗證 Remote Config 範本

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

發布 Remote Config 範本

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

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

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

請按照下列步驟發布範本：

  1. 在 Firebase 控制台中，依序前往「DevOps & Engagement」 >「遠端設定」 >「參數或條件」頁面。

  2. 開啟「 Menu」(選單)，然後選取「Publish from a file」(從檔案發布)。

  3. 出現提示時，按一下「Browse」(瀏覽)，前往並選取要發布的 Remote Config 檔案，然後按一下「Select」(選取)。

  4. 檔案已通過驗證。如果驗證成功，請按一下「Publish」(發布)，立即將設定套用至應用程式和使用者。

後續步驟