前言

如果你經(jīng)常使用 Docker Compose 來管理多容器應(yīng)用，一定會遇到這樣的場景：在項目目錄下直接敲 docker compose up，然后它就“神奇地”找到了你的配置文件。但如果你沒指定 -f 參數(shù)，它到底是怎么找到文件的呢？

默認(rèn)查找順序

當(dāng)你運行 docker compose up(注意是帶空格的 V2 版本命令)而沒有使用 -f 指定配置文件時，Docker Compose 會按照嚴(yán)格的優(yōu)先級順序在當(dāng)前工作目錄中自動查找以下文件：

1. compose.yaml (官方強烈推薦，最高優(yōu)先級)
2. compose.yml
3. docker-compose.yaml
4. docker-compose.yml (為了兼容老項目保留)

只要找到第一個存在的文件，它就會停止查找并使用該文件。

注意：這個順序是有先后順序的！如果你目錄里同時存在 compose.yaml 和 docker-compose.yml，Docker Compose 會優(yōu)先選擇 compose.yaml。

為什么推薦使用compose.yaml？

從 Docker Compose V2 開始(也就是現(xiàn)在集成在 Docker CLI 中的版本)，官方明確推薦使用 compose.yaml 作為默認(rèn)文件名。主要原因有：

• 更簡潔(去掉了多余的連字符)
• 與現(xiàn)代 YAML 命名規(guī)范更一致
• 避免與已棄用的舊工具 docker-compose(帶連字符的獨立版本)混淆
• 更好的向前兼容性：新項目統(tǒng)一用 compose.yaml，老項目繼續(xù)支持舊名字

你可以把這當(dāng)成一個“最佳實踐”：新項目一律用 compose.yaml。

實際例子

假設(shè)你的項目目錄結(jié)構(gòu)如下：

my-app/
├── compose.yaml
├── compose.yml
├── docker-compose.yml
└── Dockerfile

執(zhí)行 docker compose up 時：

• 會直接使用 compose.yaml
• 完全忽略其他同類文件

如果你刪掉 compose.yaml，它才會依次嘗試 compose.yml，再往后是 docker-compose.yml。

關(guān)于 Override 文件

同樣的規(guī)則也適用于 override 文件(用于覆蓋主配置)：

• 默認(rèn)會查找 compose.override.yaml 或 compose.override.yml
• 舊格式 docker-compose.override.yml 也支持，但優(yōu)先級較低

小貼士

想明確指定文件？始終使用 -f 參數(shù)，例如：

docker compose -f docker-compose.yml up

多配置文件合并？可以用多個 -f：

docker compose -f compose.yaml -f compose.prod.yaml up

檢查當(dāng)前使用的配置文件？運行：

docker compose config

它會顯示最終合并后的配置。

總結(jié)

Docker Compose 的配置文件查找規(guī)則其實非常人性化：既保留了對老項目的兼容性，又在推動大家向更現(xiàn)代的命名方式遷移。

建議所有新項目立即切換到 compose.yaml，既符合官方推薦，也能避免未來可能的兼容性困擾。

下次運行 docker compose up 時，不妨檢查一下你的項目里用的是哪個文件名——也許是時候重命名了呢？

到此這篇關(guān)于docker compose up 命令，默認(rèn)配置文件自動查找規(guī)則的文章就介紹到這了,更多相關(guān)docker compose up 命令內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論