部署目標

部署目標是由您自行定義的簡稱 ID Firebase 專案中的 Firebase 資源，例如有專屬資訊的 Hosting 網站使用相同安全性的靜態資產或 Realtime Database 執行個體群組不過，編寫這類演算法並不容易因為我們無法寫出所有可能的規則

如果發生以下情況，部署目標會相當實用多個 Hosting 網站，多個 Cloud Storage 值區，或多個 Realtime Database 執行個體。有了部署目標，Firebase CLI 就能將設定部署至特定專案中的 Firebase 資源或資源群組，例如：

每個 Hosting 網站的代管設定
專案目錄中個別 Hosting 的靜態資產網站
多個或多個 Realtime Database 執行個體共用的安全性規則 Cloud Storage 個值區

如要設定部署目標：

套用TARGET_NAME至指定的 Firebase 或 Firebase 資源群組
在您的 firebase.json 檔案中，參照相關聯的 TARGET_NAME 指定每項資源或資源群組的設定時

當您執行 Firebase CLI 指令時 (例如 firebase deploy)，Firebase CLI 會將每個 TARGET_NAME 與其相關聯的 Firebase 資源CLI 會與 Firebase 通訊並逐一完成每項資源的設定

為 Firebase 資源設定部署目標

使用 Firebase CLI，套用 TARGET_NAME (也就是； Firebase 支援下列產品的部署目標：

Firebase Hosting 個網站
Cloud Storage for Firebase 個儲存空間值區
Firebase Realtime Database 個執行個體

，瞭解如何調查及移除這項存取權。

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

設定「Hosting」的部署目標

如要建立部署目標並將 TARGET_NAME 套用至 Hosting 網站，請執行以下指令：加入以下 CLI 指令：

firebase target:apply TYPE TARGET_NAME RESOURCE_IDENTIFIER

其中的參數如下：

TYPE：相關的 Firebase 資源類型
- 如果是 Firebase Hosting 網站，請使用 hosting。
TARGET_NAME：你顯示的 Hosting 網站專屬名稱部署至
RESOURCE_IDENTIFIER - Hosting 網站的 SITE_ID， 列在 Firebase 專案中

舉例來說，假設您建立了兩個網站 (myapp-blog 和 myapp-app)，您可以套用每個網站的不重複 TARGET_NAME (分別為 blog 和 app) 執行下列指令：

firebase target:apply hosting blog myapp-blog

firebase target:apply hosting app myapp-app

為 Cloud Storage 或 Realtime Database 設定部署目標

如要建立部署目標，並將 TARGET_NAME 套用至一組 Cloud Storage 或 Realtime Database 資源，請執行下列 CLI 指令：

firebase target:apply TYPE TARGET_NAME RESOURCE-1_IDENTIFIER RESOURCE-2_IDENTIFIER ...

其中的參數如下：

TYPE：相關的 Firebase 資源類型
- 如果是 Cloud Storage 值區，請使用 storage。
- 如果是 Realtime Database 執行個體，請使用 database。
TARGET_NAME：資源或資源群組的專屬名稱共用安全性規則
RESOURCE_IDENTIFIER：資源的識別碼 列在 Firebase 專案中 (例如 Storage 值區名稱或資料庫) 執行個體 ID)

舉例來說，您可以將 main 的 TARGET_NAME 套用至三個群組的一組 Cloud Storage 區域性值區 (所有值區共用相同的安全性規則) ，請執行下列指令：

firebase target:apply storage main myproject.appspot.com myproject-eu myproject-ja

請注意，myproject.appspot.com 是預設值區的 ID。而 myproject-eu 和 myproject-ja 則是在 Firebase 專案

設定 firebase.json 檔案以使用部署目標

為 Firebase 資源設定部署目標後，請逐一參照已套用TARGET_NAME firebase.json 設定檔：

為每個 Firebase 資源「TYPE」建立設定物件陣列 (hosting、storage 或 database)。
在陣列中指定 target (使用 TARGET_NAME) 並定義您可以為相關聯的 Firebase 資源或資源群組進行設定。

延續上方範例，你的 Firebase 專案有兩個 Hosting 個網站和三個 Cloud Storage 值區 (共用相同的) 安全性規則)，您的 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
    }
  ]
}

{
  "storage": [ {
      "target": "main",  // "main" is the applied TARGET_NAME for the group of Cloud Storage buckets
      "rules": "storage.main.rules"  // the file that contains the shared security rules
    }
  ]
}

如果資源有多項設定，您可以建立多項設定並在 firebase.json 檔案中指定每個目標。所有相關執行 firebase deploy 時，系統會一併部署資源。

管理部署目標

部署目標的設定會儲存在您的 .firebaserc 檔案中專案目錄如要管理專案的部署目標，方法是執行執行下列指令。

指令	說明
`firebase target`	列出目前專案目錄的部署目標
`firebase target:remove \ TYPE RESOURCE_IDENTIFIER`	從指派的目標中移除資源
`firebase target:clear \ TYPE TARGET_NAME`	從指定中移除所有資源或 Hosting 網站目標

target:remove 和 target:clear 指令會自動更新部署目標設定。.firebaserc

先在本機測試再部署

指令	說明
`firebase emulators:start`	模擬專案中「所有」已設定的資源目錄
`firebase emulators:start \ --only hosting:TARGET_NAME`	只模擬Hosting內容的和設定指定 Hosting 網站
`firebase emulators:start \ --only storage:TARGET_NAME`	只模擬指定 Cloud Storage 的規則檔案目標
`firebase emulators:start \ --only database:TARGET_NAME`	僅模擬指定 Realtime Database 目標的規則檔案

進一步瞭解如何設定及使用 Firebase Local Emulator Suite。

部署特定 Firebase 資源

指令	說明
`firebase deploy`	在專案中建立「所有」可部署資源的版本目錄
`firebase deploy \ --only hosting:TARGET_NAME`	僅部署叢集的 Hosting 內容和設定指定了 Hosting 個網站做為該網站的上線頻道
`firebase hosting:channel:deploy CHANNEL_ID \ --only TARGET_NAME`	僅部署叢集的 Hosting 內容和設定將 Hosting 個網站指定為預覽頻道網站
`firebase deploy \ --only storage:TARGET_NAME`	僅部署指定 Cloud Storage 的規則檔案目標
`firebase deploy \ --only database:TARGET_NAME`	僅部署指定 Realtime Database 目標的規則檔案