部署上線(&A);透過 GitHub 提取要求預覽管道

您可以透過 GitHub 動作,將部署作業整合至 Firebase Hosting。接下來 這項 GitHub 動作能為您做什麼:

  • 為每個 PR 建立新的預覽頻道 (以及相關聯的預覽網址) GitHub 存放區

  • 在提交至版本時,使用預覽網址為提交至版本註解,方便您和審查人員在應用程式的「預覽」版本中查看及測試提交至版本的變更。

    含有預覽網址的 GitHub 動作 PR 留言圖片

  • 自動部署至相關的預覽管道,藉此更新預覽網址,納入每個版本的變更。網址不會隨著每次新的提交而變更。

  • (選用) 將 GitHub 存放區的目前狀態部署至上線 頻道。

提醒:使用預覽網址時,應用程式會與實際後端互動 管理 Firebase 專案的資源

設定要部署至「Firebase Hosting」的 GitHub 動作

  1. 建立 GitHub 存放區 (公開或私人),或使用現有的存放區。個人中心 必須具備存放區的管理員權限。

  2. 在本機版本的存放區中,使用 firebase init 指令設定 Firebase Hosting

    • 如果您尚未設定 Hosting,請從本機目錄的根目錄執行這個版本的指令:

      firebase init hosting
    • 如果您已設定 Hosting,只需設定 Hosting 的 GitHub Action 部分。在本機目錄的根目錄中執行此版本的指令:

      firebase init hosting:github
  3. 按照 CLI 提示操作,指令會自動處理 GitHub Action 設定:

    • 在 Firebase 專案中建立服務帳戶,並授予部署至 Firebase Hosting 的權限。

    • 將該服務帳戶的 JSON 金鑰加密,並以 GitHub 密鑰的形式上傳至指定的 GitHub 存放區。

    • 寫入參照新建立的密鑰的 GitHub 工作流程 yaml 設定檔。這些檔案會設定要部署的 GitHub 動作 Firebase Hosting

  4. 在 GitHub 中建立新的分支版本,並提交已建立的工作流程 yaml 檔案 CLI 指令列介面

  5. 將分支發布至 GitHub 存放區。

  6. 合併分支版本。

這樣就可以了!這個 GitHub 存放區中的任何後續 PR 都會自動取得 「預覽網址」!

進一步瞭解 GitHub Action

  • Firebase 會維護「部署至 Firebase Hosting」GitHub Action 做為開放原始碼專案。查看原始碼

  • 「部署至 Firebase Hosting」GitHub Action 例如自訂預覽管道的到期日 設定要部署在 PR 時的非直播頻道。 瞭解可用的設定選項。

  • 進一步瞭解 GitHub Actions