指定專案名稱

預設情況下，Compose 根據包含 Compose 檔案的目錄名稱分配專案名稱。您可以透過多種方法覆蓋此設定。

本頁提供了自定義專案名稱有用的場景示例，概述了設定專案名稱的各種方法，並提供了每種方法的優先順序順序。

注意

預設專案目錄是 Compose 檔案的基本目錄。也可以使用 --project-directory 命令列選項 為其設定自定義值。

示例用例

Compose 使用專案名稱來隔離不同的環境。在以下多個場景中，專案名稱都很有用：

• 在開發主機上：建立單個環境的多個副本，這對於為專案的每個功能分支執行穩定的副本很有用。
• 在 CI 伺服器上：透過將專案名稱設定為唯一的構建編號來防止構建之間的干擾。
• 在共享或開發主機上：避免可能共享相同服務名稱的不同專案之間的干擾。

設定專案名稱

專案名稱必須只包含小寫字母、十進位制數字、連字元和下劃線，並且必須以小寫字母或十進位制數字開頭。如果專案目錄或當前目錄的基本名稱違反此約束，則可以使用其他機制。

每種方法的優先順序順序從高到低如下：

1. -p 命令列標誌。
2. COMPOSE_PROJECT_NAME 環境變數。
3. Compose 檔案中的頂級 name: 屬性。或者，如果您使用 -f 標誌在命令列中指定多個 Compose 檔案，則為最後一個 name:。
4. 包含 Compose 檔案的專案目錄的基本名稱。或者，如果您使用 -f 標誌在命令列中指定多個 Compose 檔案，則為第一個 Compose 檔案的基本名稱。
5. 如果未指定 Compose 檔案，則為當前目錄的基本名稱。

下一步是什麼？

• 閱讀有關使用多個 Compose 檔案的資訊。
• 探索一些示例應用程式。