在多個網站上共用專案資源

您可以在單一 Firebase 專案中設定一或多個 Firebase Hosting 網站。由於這些網站都位於同一個 Firebase 專案中，因此所有網站都能存取專案的其他 Firebase 資源。

• 每個網站都有專屬的代管設定。
• 每個網站都會代管自己的內容集合。
• 每個網站都可以有一個或多個關聯網域。

在同一項 Firebase 專案中設定多個 Hosting 網站後，就能在相關網站和應用程式之間輕鬆共用 Firebase 資源。舉例來說，如果您在同一項 Firebase 專案中將網誌、管理面板和公開應用程式都設為個別網站，這些成員就能共用相同的 Firebase Authentication 使用者資料庫，同時擁有自己的專屬網域或內容。

步驟 1：更新 Firebase CLI 版本

更新至最新版 Firebase CLI，即可存取最新的 Firebase Hosting 功能。

步驟 2：新增其他網站

使用下列任一方法，將其他網站新增至 Firebase 專案：

• 使用 Firebase 主控台「Hosting」頁面中的工作流程

• 使用 Firebase CLI 指令： firebase hosting:sites:create SITE_ID

• 使用 Hosting REST API： projects.sites.create

針對這些方法，您必須指定 SITE_ID，用於為網站建構 Firebase 佈建的預設子網域：

• SITE_ID.web.app
• SITE_ID.firebaseapp.com

由於 SITE_ID 會用於這些網址，因此網站 ID 必須符合下列規定：

• 必須是有效的主機名稱標籤，也就是不得包含 .、_ 等字元。
• 長度不得超過 30 個半形字元
• 在 Firebase 中不得重複

您也可以選擇為每個網站新增自訂網域，為多個網址提供相同的內容和設定。

刪除次要網站

使用下列其中一種方法，從 Firebase 專案中刪除不必要的網站：

• 使用 Firebase 主控台「Hosting」頁面中的工作流程

• 使用 Firebase CLI 指令： firebase hosting:sites:delete SITE_ID

• 使用 Hosting REST API：projects.sites.delete

請注意，您無法刪除預設網站，因為該網站的 SITE_ID 與 Firebase 專案 ID 相同。

步驟 3：為網站設定部署目標

如果您有多個網站，並執行 Firebase CLI 部署指令，CLI 就需要一種方式來傳達應將哪些設定部署至各個網站。透過部署目標，您可以在 firebase.json 設定檔和 Firebase CLI 指令中使用 TARGET_NAME，藉此唯一識別特定網站，以便測試或部署至網站。

如要建立部署目標，並將 TARGET_NAME 套用至 Hosting 網站，請在專案目錄的根目錄中執行下列 CLI 指令：

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

其中參數如下：

• TARGET_NAME：您要部署至 Hosting 網站的專屬名稱 (由您自行定義)

• RESOURCE_IDENTIFIER：Hosting 網站的 SITE_ID，如在 Firebase 專案中列出

舉例來說，如果您在 Firebase 專案中建立了兩個網站 (myapp-blog 和 myapp-app)，可以執行下列指令，為每個網站套用專屬的 TARGET_NAME (分別為 blog 和 app)：

firebase target:apply hosting blog myapp-blog

firebase target:apply hosting app myapp-app

部署目標的設定會儲存在專案目錄中的 .firebaserc 檔案中，因此每個專案只需設定一次部署目標。

步驟 4：定義每個網站的代管設定

在 firebase.json 檔案中定義網站的代管設定時，請使用網站已套用的 TARGET_NAME。

• 如果 firebase.json 檔案定義多個網站的設定，請使用陣列格式：

  {
    "hosting": [ {
        "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
        "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"
  
        // ...
      },
      {
        "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
        "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"
  
        // ...
  
        "rewrites": [...]  // You can define specific Hosting configurations for each site
      }
    ]
  }

• 如果 firebase.json 檔案只定義一個網站的設定，則不必使用陣列格式：

  {
    "hosting": {
        "target": "blog",
        "public": "dist",
  
        // ...
  
        "rewrites": [...]
    }
  }

步驟 5：在本機測試、預覽變更，並部署至網站

從本機專案目錄根目錄執行下列任一指令。