指定專案名稱

在 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 檔案的相關資訊。
• 探索一些範例應用程式。