管理上線的版本(&A);預覽版本、版本和網站版本

Firebase Hosting 可透過 Firebase 控制台和 Firebase CLI 提供相關工具,協助您管理 Hosting 網站的版本、版本和版本。

Hosting 基礎架構總覽

瞭解 Hosting 基礎架構有助您瞭解本頁所述的管理選項。

每個 Firebase 專案都有預設的 Hosting 網站,可以存取專案的所有資源 (資料庫、驗證、函式等)。網站包含一或多個「管道」,其中每個頻道都會與提供特定內容和 Hosting 設定的網址建立關聯。

<span class=Firebase 代管階層" />

每個 Hosting 網站都有一個「live」頻道,可在 (1) 網站的 Firebase 佈建的子網域 (SITE_ID.web.appSITE_ID.firebaseapp.com) 和 (2) 任何已連結的自訂網域中提供內容和 Hosting 設定。您也可以選擇建立「預覽」管道,在可共用的臨時「預覽網址」(SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app) 中提供自有內容和設定。

每個管道提供的內容和設定會封裝為具有專屬 ID 的 version 物件。部署至網站時,Firebase 會建立指向特定版本的 release 物件。版本包含部署作業的中繼資料,例如誰部署了版本,以及部署時間。

在 Firebase 專案的 Hosting 資訊主頁中,您可以在「版本記錄」表格中查看進行中版本版本的完整記錄。如果您有多個 Hosting 網站,請按一下所需網站的「查看」,查看該網站的發布記錄。如果您有任何預先發布版頻道,這些頻道也會顯示在 Hosting 資訊主頁上。

管理頻道設定

你可以控制網站的每個管道設定。部分設定 (例如頻道到期日) 僅適用於預覽版本。

限制要保留的版本數量

每次部署至管道 (並建立版本) 時,Hosting 會在專案的 Hosting 儲存空間中保留與先前版本相關聯的版本。您可以為專案中的每個管道 (直播和預覽管道) 設定要保留的版本數量。

  • Hosting 為什麼會保留先前的版本?
    如果是直播頻道,保留先前版本可讓您在需要時回溯至先前的網站版本。對於預覽版頻道,目前尚未提供回溯功能。

  • 為什麼要限制要保留的版本數量?
    這項功能可協助您控管專案的 Hosting 儲存空間的使用率,因為先前版本的內容會保留在這個儲存空間中。您可以在控制台的「儲存空間」分頁中,監控 Hosting 儲存空間。

  • 限制保留的版本後會發生什麼事?
    設定保留版本數量上限後,系統會安排刪除超出設定限制的所有版本內容,從最舊的版本開始

以下說明如何設定頻道的發布儲存空間上限:

  1. Firebase 控制台中,前往版本儲存空間設定對話方塊:

    • 直播頻道
      在網站的「發布記錄」表格中,按一下 ,然後選取「發布儲存空間設定」

    • 任何預覽管道
      在預覽版本的資料列中,按一下 ,然後選取「管道設定」

  2. 輸入您要保留的版本數量,然後按一下「儲存」

設定預覽管道的到期日

根據預設,預覽管道會在建立當天算起 7 天後到期,但網站的上線頻道永遠不會過期。

預覽管道到期後,系統會在 24 小時內刪除該管道、相關版本和相關聯的版本。相關聯的預覽網址也會一併停用。版本刪除作業的例外狀況是,如果某個版本與其他版本相關聯 (例如,如果您將某個版本從一個管道複製到同一個網站的另一個管道)。

Hosting 支援兩種不同的管道,用來控制管道的到期日:

  • Firebase 控制台
    在預覽版本的資料列中,按一下 ,然後選取「Channel settings」。輸入到期日的日期和時間。

  • Firebase CLI
    將應用程式部署至預先發布版管道時,請傳遞 --expires DURATION 標記,例如:

    firebase hosting:channel:deploy new-awesome-feature --expires 7d

    到期日可設為部署日期後最多 30 天。使用 h 代表小時,d 表示天,w 則使用週 (例如 12h7d2w)。

複製某個版本中的某個版本

您可以將已部署的版本複製到其他管道。您可以跨實體或預先發布版管道、跨 Hosting 網站,甚至跨 Firebase 專案複製管道。

複製指令也會將部署至「目標」管道,以便讓複製的 Hosting 內容和設定自動在「目標」頻道的關聯網址提供。

這項功能可用於追蹤版本,或是讓您確信在其他管道中查看和/或測試的內容是確切的內容。例如:

  • 從「QA」預覽頻道複製至網站的直播頻道 (即將直播)

  • 從網站的即時版本複製到「偵錯」預覽管道 (例如復原前)

  • 從「staging」Firebase 專案中的管道複製至「prod」Firebase 專案中的預覽管道

如要複製版本,請在任何目錄中執行下列指令:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

將每個預留位置替換為以下內容:

  • SOURCE_SITE_IDTARGET_SITE_ID:這是包含管道的 Hosting 網站 ID。

    • 如要使用預設 Hosting 網站,請使用 Firebase 專案 ID。
    • 您可以指定位於同一個 Firebase 專案或不同 Firebase 專案中的 Hosting網站。
  • SOURCE_CHANNEL_IDTARGET_CHANNEL_ID:這是頻道的 ID。

    • 如為直播頻道,請使用 live 做為頻道 ID。
    • 如果指定的「目標」管道尚不存在,這個指令會在部署前建立管道。

還原至網站先前版本

你可以回溯至先前版本的網站直播頻道。如果目前的版本有問題,而您想回溯到已知可正常運作的網站版本,這項操作就很實用。或者,您的網站仍可能為節慶或特殊活動提供暫時性內容,但現在您想要復原,改為放送「一般」內容。

復原後,您可以建立新版本,提供與先前版本相同的內容版本。在您的「版本記錄」表格中,這兩個版本都會列出相同的版本 ID。

復原的步驟如下:

  1. 前往 Firebase 控制台,在網站的「版本記錄」表格中,將遊標懸停在要復原的先前版本項目上。

  2. 按一下 ,然後選取「回溯」

手動刪除版本

您可能需要從線上版本手動刪除版本,才能為專案釋出 Hosting 儲存空間。您只能刪除先前的版本,無法刪除目前在實體網站上提供的版本。

刪除版本時,您實際上是刪除版本的內容,而系統會在 24 小時內刪除這些內容。發布物件本身會保留,因此您仍可查看其中繼資料 (誰部署及何時部署)。

以下說明如何刪除版本:

  1. Firebase 控制台的網站「發布記錄」表格中,將滑鼠游標懸停在要刪除的先前發布項目上。

  2. 按一下 ,然後選取「刪除」

手動刪除檔案

Firebase Hosting 中,從已部署的網站刪除所選檔案的主要方法,是刪除本機檔案,然後重新部署。

手動刪除預覽頻道

只要按一下要預覽的管道,即可預覽管道。在這個檢視畫面中,您可以查看、刪除及還原與特定管道相關聯的最新部署與發布版本。你可以刪除預覽頻道,但無法刪除網站的直播頻道。

刪除預先發布管道後,系統會在 24 小時內刪除該管道、相關版本和相關聯的版本。而相關的預覽網址也會停用。版本刪除作業的例外狀況是,如果某個版本與其他版本相關聯 (例如,如果您將某個版本從一個管道複製到同一個網站的另一個管道)。

Hosting 支援兩種刪除預覽頻道的方式:

  • Firebase 主控台
    在預覽管道的資料列中,按一下 ,然後選取「刪除管道」。確認刪除。

  • Firebase CLI
    在任何目錄中執行下列指令:

    firebase hosting:channel:delete CHANNEL_ID

預覽版本與複製的 CLI 指令

預覽管道的指令

如果您有多個 Hosting 網站,則所有預覽頻道指令都支援部署目標。

指令 說明
firebase hosting:channel:create CHANNEL_ID

使用指定的 CHANNEL_ID預設 Hosting 網站中建立新的預覽頻道

這個指令不會部署至頻道。

firebase hosting:channel:delete CHANNEL_ID

刪除指定預覽管道

您無法刪除網站的直播頻道。

firebase hosting:channel:deploy CHANNEL_ID

Hosting 內容和設定部署至指定的預覽頻道

如果預先發布版尚不存在,這個指令會在部署至管道前,先在預設 Hosting 網站上建立版本。

firebase hosting:channel:list 列出預設 Hosting 網站中的所有頻道 (包括「live」頻道)
firebase hosting:channel:open CHANNEL_ID 開啟瀏覽器並前往指定頻道的網址,或在無法透過瀏覽器開啟的情況下傳回網址

用於複製版本的指令

指令 說明
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

將指定「來源」管道中最近部署的版本複製到指定的「目標」管道

這個指令也會部署至指定的「目標」管道。如果「目標」頻道尚未建立,這項指令會先在「目標」Hosting 網站中建立新的預覽頻道,再部署至頻道。

firebase hosting:clone \
SOURCE_SITE_ID:@VERSION_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

將指定版本複製到指定的「目標」版本

這個指令也會部署至指定的「目標」管道。如果「目標」頻道尚未建立,這項指令會先在「目標」Hosting 網站中建立新的預覽頻道,再部署至頻道。

您可以在 Firebase 控制台的 Hosting 資訊主頁中找到 VERSION_ID