指定專案名稱

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