部署到現場並部署透過 GitHub 拉取請求預覽頻道

您可以透過 GitHub Action 將部署整合到 Firebase Hosting。以下是此 GitHub Action 可以為您做的事情:

  • 為 GitHub 儲存庫上的每個 PR 建立一個新的預覽通道(及其關聯的預覽 URL)。

  • 使用預覽 URL 新增評論到 PR,以便您和每個審閱者可以在應用程式的「預覽」版本中查看和測試 PR 的變更。

    預覽 URL 的 GitHub Action PR 評論的圖像

  • 透過自動部署到關聯的預覽頻道,使用每次提交的變更來更新預覽 URL。 URL 不會隨著每次新提交而改變。

  • (可選)合併 PR 時,將 GitHub 儲存庫的目前狀態部署到即時頻道。

提醒:使用預覽 URL 時,您的應用程式會與 Firebase 專案的真實後端資源互動。

設定 GitHub Action 以部署到 Firebase Hosting

  1. 建立 GitHub 儲存庫(公有或私人)或使用現有儲存庫。您必須擁有儲存庫的管理員權限。

  2. 在儲存庫的本機版本中,使用firebase init指令設定 Firebase 託管。

    • 如果您尚未設定託管,請從本機目錄的根目錄執行此版本的命令:

      firebase init hosting
    • 如果您已經設定了託管,那麼您只需設定託管的 GitHub Action 部分。從本機目錄的根目錄執行此版本的命令:

      firebase init hosting:github
  3. 依照 CLI 提示操作,該指令將自動設定 GitHub 操作:

    • 在您的 Firebase 專案中建立一個有權部署到 Firebase 託管的服務帳戶。

    • 加密該服務帳戶的 JSON 金鑰並將其作為GitHub Secret上傳到指定的 GitHub 儲存庫。

    • 寫入引用新建立的金鑰的 GitHub 工作流程yaml設定檔。這些檔案配置 GitHub Action 以部署到 Firebase Hosting。

  4. 在 GitHub 中,建立一個新分支並提交由 CLI 建立的工作流程yaml檔案。

  5. 將分支發佈到您的 GitHub 儲存庫。

  6. 合併分支。

就是這樣!此 GitHub 儲存庫中的任何後續 PR 都將自動獲得自己的「預覽 URL」!

了解有關 GitHub 操作的更多信息

  • Firebase 將「部署到 Firebase 託管」GitHub Action 作為開源專案進行維護。查看原始碼。

  • 「部署到 Firebase 託管」GitHub 作業允許進一步配置,例如自訂預覽通道的到期日期或設定在合併 PR 時部署到的非即時通道。了解可用的配置選項。

  • 整體了解有關GitHub Actions的更多資訊。