管理推出作業和版本

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

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

查看推出作業

Firebase控制台會提供應用程式所有推出作業的詳細資訊。在 App Hosting 中，選取要查看推出作業的後端「檢視」。後端的「推出」分頁會顯示表格，列出這個後端的所有推出記錄。

每個推出項目都包含 Cloud Build 工作和觸發推出的變更或提交內容的連結，以及推出作業的作者、建立日期和狀態等基本資訊。

  • Cloud Build 工作是建構環境，App Hosting 會在其中執行應用程式的建構指令。按一下建構 ID 即可存取 Cloud Build 記錄。
  • 「變更」是指觸發推出作業的 GitHub 修訂或其他動作。

手動觸發推出作業

如要從 GitHub 來源手動觸發推出作業，但不想推送新的提交內容，可以從 Firebase 控制台或 Firebase CLI 建立推出作業。這項功能在下列情況下非常實用：

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

如要在 Firebase 控制台中觸發發布作業，請按照下列步驟操作：

  1. 在 App Hosting 中，選取要建立階段發布的後端「View」(查看)。
  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. 在 App Hosting 中，選取要建立回溯的後端「View」(檢視)。
  2. 選取「推出」分頁標籤。
  3. 在後端的「記錄」表格中，選取先前版本的建構三點圖示選單。
  4. 選取「復原至這個版本」並確認。

重新建構並復原

如要還原舊版應用程式，但仍保留目前的設定，可以在回溯程序中重建應用程式。舉例來說，如果最新版本更新了 Secret Manager 中的 API 金鑰值，重建作業可確保應用程式在復原後使用新金鑰。

如要重建及復原，請按照下列步驟操作：

  1. 在 App Hosting 中，選取要建立回溯的後端「查看資訊主頁」。\
  2. 選取「推出」分頁標籤。
  3. 選取「開始發布」。
  4. 在「建立推出作業」對話方塊中，勾選「先前的提交」，然後輸入要重建及還原的版本的提交 ID。提交 ID 是「推出記錄」中列出的每個推出作業「變更詳細資料」的一部分，位於標籤的括號中。
  5. 選取「建立」即可開始回溯。

變更發布設定

如要變更發布的正式版分支，以及啟用或停用自動發布功能，請使用後端資訊主頁的「設定」>「部署」檢視畫面中的控制項。

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