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，不再維護。

移除 `version:` 欄位

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 警告。

Dockerfile 進階多階段建構

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

基礎複習：Builder + Runtime 模式

# Stage 1: 建構
FROM eclipse-temurin:21-jdk AS builder
WORKDIR /app
COPY . .
RUN ./mvnw package -q -DskipTests

# Stage 2: 執行（只複製 jar，不含 JDK 與 source code）
FROM eclipse-temurin:21-jre-jammy
COPY --from=builder /app/target/app.jar /app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

多階段建構的目的：最終 image 只含執行所需的檔案，不含原始碼、建構工具、測試依賴。

Cache Mount：加速重複建構

每次 docker build 若依賴沒有改變，Maven/npm 都會重新下載套件，非常耗時。--mount=type=cache 讓套件管理器的 cache 跨 build 持久化。