Docker Compose V2 遷移指南

Mon, 15 Jan 2024 00:00:00 +0800

V1 vs V2 的本質差異

	V1	V2
執行檔	`docker-compose`（Python）	`docker compose`（Go，Docker CLI plugin）
安裝方式	獨立 binary，另行安裝	Docker Desktop 內建；Linux 用 `docker compose plugin`
`version:` 欄位	必填（決定語法版本）	已廢棄，出現時忽略並發出警告
網路命名	`<project>_default`（底線）	`<project>-default`（連字號）
啟動指令	`docker-compose up`	`docker compose up`

V1 已於 2023 年 7 月正式 EOL，不再維護。

V1 時代的 version: "3.9" 決定 Compose 文件語法版本。V2 不再有版本差異，統一支援最新語法。

# V1 寫法（過時，V2 會警告）
version: "3.9"
services:
  app:
    image: my-app:latest

# V2 正確寫法（刪除 version 欄位）
services:
  app:
    image: my-app:latest

移除後不影響任何功能，僅消除 the attribute version is obsolete 警告。