管理推出作業和版本

如果您已啟用自動推出功能,每當您將新的修訂版本推送至 GitHub 存放區中的實際分支版本時,App Hosting 就會自動推出應用程式的新版本。您可以在 Firebase 主控台或 App Hosting GitHub 檢查中查看推出狀態。

此外,App Hosting 支援手動觸發的 CI/CD 整合推出作業,或任何您想強制推出的情況。

查看推出作業

Firebase 控制台可讓您查看應用程式所有版本的詳細資訊。在 App Hosting 分頁中,選取您想查看版本資訊的後端,然後點選「View dashboard」。資訊主頁會顯示目前推播的相關資訊,以及列出此後端所有推播記錄的表格。

主控台的推行視圖螢幕截圖

每個推行內容都包含 Git 提交、Cloud Build 工作和 Cloud Run 修訂版本。

  • Git 提交是指推出時存放區的快照。
  • Cloud Build 工作是 App Hosting 執行應用程式建構指令的建構環境。如要存取 Cloud Build 記錄,請在 Firebase 主控台中按一下建構 ID。
  • Cloud Run 修訂版本是網頁應用程式的執行階段環境。如要進一步瞭解推出作業的執行階段設定 (例如 CPU 和記憶體上限、環境變數),請按一下三點選單,然後選取「View Cloud Run revision」

手動觸發推出作業

如果您想手動觸發 GitHub 來源的推出作業,但不推送新的版本,可以透過 Firebase 主控台或 Firebase CLI 建立推出作業。這項功能適用於以下情況:

  • 強制重新產生靜態內容。
  • 允許 CI/CD 系統觸發推出作業。
  • 將正式版推出時間限制在特定日期或時間。

如何在 Firebase 主控台中觸發發布作業:

  1. App Hosting 分頁中,選取要建立推播作業的後端的「查看資訊主頁」
  2. 在後端資訊主頁中,選取「建立推行計畫」
  3. 選取要部署的分支。
  4. 選取要部署的修訂版本,可以是最新修訂版本,也可以是修訂版本 ID 指定的較早修訂版本。
  5. 選取 [Create] (建立)。推出作業的狀態和版本編號會顯示在推出作業記錄資料表中。推出程序完成後,這項推出作業就會顯示為目前的推出作業。

如要在 Firebase CLI 中觸發發布作業,請執行下列指令,並在系統提示時選取發布分支:

firebase apphosting:rollouts:create BACKEND_ID

或者,您也可以使用 --git-branch 選項,為特定分支啟動最新版本的部署作業:

firebase apphosting:rollouts:create BACKEND_ID
--git_branch BRANCH_NAME

您也可以使用 --git-commit 選項,針對特定版本建立推行計畫:

firebase apphosting:rollouts:create BACKEND_ID
--git_commit COMMIT_ID

還原先前的推行作業

App Hosting 提供兩種還原先前版本的選項:

  • 無須重建,即可立即回溯
  • 重新建構並還原至先前版本

建立即時回溯

有時您可能需要快速還原舊版應用程式,例如在新部署的版本中發現重大錯誤,或是遇到導致無法部署新版本的異常版本。在這種情況下,您可以從先前的推出作業中,還原所選的現有容器映像檔。這個映像檔不會重建,而是使用首次建構時的程式碼和環境設定。

如何建立即時回溯:

  1. 在「應用程式代管」分頁中,選取要建立回溯功能的後端,然後選取「查看資訊主頁」
  2. 在後端的「Rollout history」表格中,選取先前版本的三點圖示選單。
  3. 選取「復原至這個版本」並確認。

重新建構及復原

如果您想還原舊版應用程式,但仍保留目前設定,可以透過還原程序重建應用程式。舉例來說,如果最新版本在 Secret Manager 中更新了 API 金鑰值,重新建構作業可以確保在復原後,應用程式會使用新金鑰。

如要重新建構及回溯,請按照下列步驟操作:

  1. 在「應用程式代管」分頁中,選取要建立回溯作業的後端,然後選取「查看資訊主頁」
  2. 選取「建立發布計畫」
  3. 在「Create a rollout」對話方塊中,勾選「Earlier commit」,然後輸入要重建及回溯至的版本的提交 ID。每個推出記錄中列出的推出項目,其「變更詳細資料」部分都會包含提交 ID,並在標籤中以括號表示。
  4. 選取「建立」即可開始回復。

變更發布設定

您可以變更要用於推出的正式分支,並在後端的資訊主頁中,透過「設定」>「部署」檢視畫面中的控制項,停用或啟用自動部署功能。

  1. App Hosting 分頁中,選取要更新發布設定的後端,然後選取「查看資訊主頁」
  2. 在後端資訊主頁中,選取「設定」。預設檢視畫面會顯示網域和自訂網域的相關資訊。
  3. 選取「Deployment」檢視畫面。在這個檢視畫面中,您可以變更推出功能的正式分支,並停用或啟用自動推出功能。此外,您也可以設定應用程式根目錄和後端環境 (請參閱「部署至多個環境」)。