Docker Compose 教學:一個 YAML 開起網站+資料庫

Docker Compose 是用一個 YAML 檔描述多個容器,一行 docker compose up -d 就全部開起來的工具。

第 6 篇做的留言板,光是開起來就要:建網路、跑一個 9 行的 MySQL 指令、盯日誌等它好、build 映像檔、再跑一個 9 行的網頁指令。總共二十幾行,密碼重複出現 4 次,而且這些指令只活在終端機的歷史紀錄裡。

這篇把那二十幾行收進一份 docker-compose.yml,之後開、關、看日誌、改程式重建都只要一行。你會實際看到:Compose 自動建網路、真的等資料庫健康了才開網頁、down 之後資料還在,還有 YAML 用了 Tab 會出現什麼錯誤訊息。

這是「容器系列」的第 7 篇,全部在免費的 Cloud Shell 實際跑過,輸出都是真實結果(2026 年 10 月實測,Docker 29.8.1、MySQL 8.0.46)。這篇接著第 6 篇的留言板做,沒做過也沒關係,下面會說怎麼補。

Dockerfile 像一道菜的食譜,docker-compose.yml 像整桌套餐的出菜單:有哪幾道菜、誰先上、放在同一桌

為什麼你需要知道

  • 多容器的指令記不住:資料庫要掛哪個路徑、環境變數叫什麼、誰要先開,全靠記憶,換一台機器或過三個月就忘了
  • 新同事要花半天建環境:有了 Compose,README 寫「docker compose up -d」就好,一行把整套開發環境開起來
  • 密碼不再散落在指令裡:搭配 .env 檔,設定檔可以放上 Git,密碼不會跟著上去
  • 面試常問:「Compose 和 Dockerfile 差在哪」「depends_on 能保證資料庫準備好嗎」「down 和 down -v 差在哪」都是常見題

Docker Compose 是什麼?

白話是什麼

Docker Compose 是一個「多容器說明書」工具:你在一個 YAML 檔裡寫好有哪些容器、各自用什麼映像檔、開哪些 Port、掛哪些 Volume、用什麼環境變數、誰要等誰,然後 docker compose up -d 一次全部開起來。

比喻:食譜和出菜單

管什麼比喻檔案
Dockerfile一個映像檔怎麼做出來一道菜的食譜:牛肉麵怎麼煮Dockerfile
Compose 檔幾個容器怎麼湊在一起跑整桌套餐的出菜單:有牛肉麵、小菜、飲料,哪道先上docker-compose.yml 或 compose.yaml

兩者是上下關係,不是二選一。Compose 檔裡的 build: . 就是「這道菜照旁邊那份食譜(Dockerfile)做」。

來龍去脈:docker-compose 和 docker compose

依 Docker 官方的 Compose 發展史(2026 年 11 月查):2014 年的 v1 是用 Python 寫的 docker-compose(中間有連字號);2020 年的 v2 用 Go 重寫成 Docker 的外掛,指令變成 docker compose(中間是空格);2025 年的 v5 功能跟 v2 一樣,主要多了官方的 Go 開發套件。為了不跟舊的 Compose「檔案格式」v2、v3 搞混,版本號直接從 v2 跳到 v5。

Docker 官方文件(2026 年 11 月查)寫明 v1 已經不再維護,請改用 v2;Docker 官方部落格公告 v1 在 2023 年中之後就不再支援。2026 年 11 月在 Cloud Shell 跑 docker compose version,顯示的是 Docker Compose version v5.7.1,這篇全部用 docker compose。

項目舊寫法(網路上很多教學還在用)現在的寫法
指令docker-compose updocker compose up
版本號v1(已不再維護)v2 之後;2025 年起是 v5
檔案開頭version: "3.8"不用寫,寫了會跳過時警告
預設檔名docker-compose.ymlcompose.yaml(官方優先),舊檔名照樣認得

關於 version::官方文件說這個欄位只剩參考用途,寫了會收到「已過時(obsolete)」的警告,Compose 一律用最新的格式檢查你的檔案。看到教學的 YAML 第一行是 version: "3",就知道它有點年紀了。

檔名方面,官方文件說預設找 compose.yaml(優先)或 compose.yml,也為了相容舊版認得 docker-compose.yaml、docker-compose.yml。這篇的實測用的是 docker-compose.yml,兩種都能跑;新專案建議直接取名 compose.yaml。

為什麼要學

就算正式環境用 Kubernetes 或 Cloud Run,工程師自己電腦上的開發環境,大多還是 docker compose up。它是從「會開一個容器」走到「會開一整套系統」的第一步。


YAML 是什麼?三個一定會踩的地雷

YAML 是一種給人看的設定檔格式,用「縮排」表示層級、用「冒號」表示「名稱:值」、用「減號」表示清單。全名是「YAML Ain’t Markup Language」,意思是它不是用標籤包來包去的格式,重點在好讀。Compose、Kubernetes、Cloud Build 的設定檔都是 YAML,學一次用很久。

person:
  name: 小明
  fruits:
    - 蘋果
    - 香蕉
地雷錯的樣子結果
縮排用了 Tab看起來一模一樣,但其實是 Tab 字元直接報錯,而且錯誤訊息不會告訴你「是 Tab」(下面有實測)
冒號後面沒空格image:nginx被當成一整串字 image:nginx,不是「image 等於 nginx」
同一層縮排沒對齊web: 多縮了兩格不報錯,但 web 變成 db 底下的設定,行為完全不對

建議:縮排一律用 2 個空格,值裡面有冒號、或看起來像數字和時間的(例如 Port 對應 "8080:8080"),就用引號包起來。


動手做:把留言板改成 Compose

在 test27 的 Cloud Shell(不用建專案、不用綁信用卡)實作,大約 15 分鐘,不花錢。截圖裡的提示字元有縮短,你的畫面會是「你的帳號@cloudshell:~/docker-course/msgboard$」。

步驟 0:準備好留言板的檔案

做完第 6 篇的話,~/docker-course/msgboard 裡已經有 app.py、requirements.txt、Dockerfile、.dockerignore,而且 msgdb-data 這個 Volume 裡有之前的留言,直接進資料夾:

cd ~/docker-course/msgboard

沒做過第 6 篇:照第 6 篇「步驟 11」把 4 個檔案建好,再建一個空的 Volume 給資料庫用:

docker volume create msgdb-data

步驟 1:把密碼搬進 .env 檔

.env 檔是一個放「名稱=值」的純文字檔,Docker Compose 會自動讀同一個資料夾裡的 .env,把值填進 Compose 檔裡的 ${名稱}。這樣密碼只寫在一個地方,Compose 檔本身可以安心放上 Git。

cat > .env <<'EOF'
MYSQL_ROOT_PASSWORD=RootPass123
MYSQL_DATABASE=msgboard
MYSQL_USER=appuser
MYSQL_PASSWORD=AppPass123
EOF

確認 .env 不會被打包進映像檔:

cat .dockerignore
__pycache__/
*.pyc
.git/
.env
*.key
venv/
cat .dockerignore 確認裡面有 .env,密碼檔不會被打包進映像檔

有 .env 那一行。.env 永遠不要進映像檔,也不要放上 Git。實務做法是把 .env 寫進 .gitignore,另外放一份裝假密碼的 .env.example 給新同事複製。

步驟 2:寫 docker-compose.yml

整段貼上:

cat > docker-compose.yml <<'EOF'
services:

  db:
    image: mysql:8.0
    container_name: msgdb
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - msgdb-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 3s
      retries: 20

  web:
    build: .
    container_name: msgapp
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      DB_HOST: db
      DB_USER: ${MYSQL_USER}
      DB_PASSWORD: ${MYSQL_PASSWORD}
      DB_NAME: ${MYSQL_DATABASE}
    depends_on:
      db:
        condition: service_healthy

volumes:
  msgdb-data:
    external: true
EOF

跟第 6 篇的指令逐項對照:

docker run 參數和 Compose 欄位對照:--name 對 container_name、-e 對 environment、-v 對 volumes、-p 對 ports、docker build 對 build、--network 由 Compose 自動建立
第 6 篇的 docker runCompose 欄位說明
mysql:8.0image: mysql:8.0用現成映像檔
docker build -t msgboard:v1 .build: .用目前資料夾的 Dockerfile 自己建
--name msgdbcontainer_name: msgdb容器名字(不寫的話 Compose 會自動取名)
-e 名稱=值environment:${...} 從 .env 讀
-v msgdb-data:/var/lib/mysqlvolumes:減號開頭是清單,可以掛好幾個
-p 8080:8080ports: - "8080:8080"加引號比較保險
docker network create+--network不用寫Compose 自動建一個網路,把所有服務放進去
盯著 docker logs 等 readyhealthcheck+depends_on讓 Compose 幫你等

有幾行要特別說明:

  • DB_HOST: db:這裡寫的是服務名稱 db,不是容器名字 msgdb。官方文件說明,Compose 會建一個叫「專案名稱_default」的網路,所有服務都放進去,服務名稱就是位址,跟第 6 篇「容器名字就是位址」是同一個原理
  • healthcheck(健康檢查):每 5 秒在 db 容器裡跑一次 mysqladmin ping(問 MySQL「你活著嗎」),超過 3 秒沒回應算失敗,連續失敗 20 次才判定不健康
  • depends_on + condition: service_healthy:web 要等 db「健康」之後才啟動。只寫 depends_on: - db 的簡單寫法,只保證 db 容器開了,不保證 MySQL 準備好了
  • restart: unless-stopped:容器掛了自動重開,但你手動停的就不會自己起來
  • external: true:這個 Volume 已經存在(第 6 篇建的),不要重建,直接用

算一次健康檢查最久會等多久:每 5 秒 × 20 次 = 最多 100 秒才放棄。第 6 篇實測 MySQL 從臨時伺服器到正式可連隔了 7 秒,100 秒的緩衝很夠。數字調小(例如 retries: 2,只等 10 秒),慢一點的機器就可能被誤判成壞掉。

restart 的值行為
no預設,掛了就掛了
always永遠重開,連你手動停的,Docker 重開後也會起來
unless-stopped自動重開,但尊重你的手動停止(最常用)
on-failure只在異常結束(結束代碼不是 0)時重開

步驟 3:先檢查設定檔

啟動前讓 Compose 先讀一次,YAML 有錯會直接告訴你:

docker compose config
(前面省略)
    depends_on:
      db:
        condition: service_healthy
        required: true
    environment:
      DB_HOST: db
      DB_NAME: msgboard
      DB_PASSWORD: AppPass123
      DB_USER: appuser
    networks:
      default: null
    ports:
      - mode: ingress
        target: 8080
        published: "8080"
        protocol: tcp
    restart: unless-stopped
networks:
  default:
    name: msgboard_default
volumes:
  msgdb-data:
    name: msgdb-data
    external: true
docker compose config 印出展開後的設定,${MYSQL_PASSWORD} 已經被換成 .env 裡的 AppPass123,網路名稱是 msgboard_default

config 會印出展開後的完整設定,從這裡可以確認三件事:

  • DB_PASSWORD: AppPass123:${MYSQL_PASSWORD} 已經被換成 .env 裡的值,代表 .env 有讀到
  • name: msgboard_default:Compose 會自動建的網路叫這個名字。官方文件說明,沒特別指定的話,專案名稱就是 Compose 檔所在的資料夾名稱,這裡是 msgboard
  • required: true:我們沒寫,是 Compose 自動補上的預設值

這個輸出會把密碼印出來,不要截圖貼到網路上。另外前面省略的部分會印出 build 的完整路徑,裡面有你的帳號名稱。

步驟 4:一行開起整套系統

docker compose up -d
[+] Building 0.6s (12/12) FINISHED
 => [internal] load local bake definitions                                       0.0s
(中間省略)
 => CACHED [2/5] WORKDIR /app                                                    0.0s
 => CACHED [3/5] COPY requirements.txt .                                         0.0s
 => CACHED [4/5] RUN pip install --no-cache-dir -r requirements.txt              0.0s
 => CACHED [5/5] COPY app.py .                                                   0.0s
(中間省略)
 => => naming to docker.io/library/msgboard-web:latest                           0.0s
[+] up 4/4
 ✔ Image msgboard-web           Built      0.7s
 ✔ Network msgboard_default     Created    0.1s
 ✔ Container msgdb              Healthy    6.0s
 ✔ Container msgapp             Started    6.2s
docker compose up -d 先建置 msgboard-web 映像檔,再建立 msgboard_default 網路,msgdb 6.0 秒變 Healthy 後 msgapp 才啟動

最後 4 行就是 Compose 幫你做的事:

Compose 自動做的第 6 篇你手動做的
Image msgboard-web Builtdocker build -t msgboard:v1 .
Network msgboard_default Createddocker network create msgboard-net
Container msgdb Healthy(6.0 秒)9 行的 MySQL 指令+盯日誌等 ready
Container msgapp Started(6.2 秒)9 行的網頁指令

注意 msgdb 那行寫的是 Healthy 不是 Started,而 msgapp 在 6.2 秒才啟動,比 msgdb 晚:Compose 真的等到健康檢查通過才開網頁。另外 build 步驟全部 CACHED,因為第 6 篇建過一樣的映像檔,快取直接拿來用。

映像檔的名字是 msgboard-web(專案名稱-服務名稱),不是第 6 篇的 msgboard:v1,這是 Compose 幫你取的。

步驟 5:看狀態、打開網頁

docker compose ps
NAME     IMAGE          COMMAND                  SERVICE   CREATED              STATUS                    PORTS
msgapp   msgboard-web   "python app.py"          web       About a minute ago   Up 55 seconds             0.0.0.0:8080->8080/tcp
msgdb    mysql:8.0      "docker-entrypoint.s…"   db        About a minute ago   Up About a minute (healthy)   3306/tcp, 33060/tcp
docker compose ps 顯示 msgapp 和 msgdb 都在執行,msgdb 狀態後面有 (healthy)

msgdb 的狀態後面多了 (healthy),這是健康檢查的結果。點 Cloud Shell 右上角「網頁預覽」→「透過以下通訊埠預覽:8080」:

用 Docker Compose 開起來的部門留言板,第 6 篇留的三則留言都還在

第 6 篇留的三則留言都還在。因為 external: true 用的是同一個 msgdb-data Volume,換了工具,資料照樣接得上。

步驟 6:一次看所有服務的日誌

docker compose logs
msgapp  | 資料庫連線成功
msgapp  | 資料表已就緒
msgapp  |  * Serving Flask app 'app'
(中間省略)
msgapp  |  * Running on http://172.19.0.3:8080
msgapp  | Press CTRL+C to quit
msgapp  | 172.19.0.1 - - [06/Oct/2026 08:13:21] "GET /?authuser=0 HTTP/1.1" 200 -
msgdb   | 2026-10-06 08:12:15+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.46-1.el9 started.
(中間省略)
msgdb   | 2026-10-06T08:12:16.755860Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.46'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  MySQL Community Server - GPL.
docker compose logs 同時顯示 msgapp 和 msgdb 的日誌,每行前面標出是哪個容器

每一行前面標出來源(msgapp、msgdb),兩個容器的日誌放在一起看,查「程式連不上資料庫」這類問題特別方便。只想看某一個服務,後面加服務名稱:

docker compose logs web
docker compose logs web 只顯示網頁服務 msgapp 的日誌

注意 msgapp 這次的 IP 是 172.19.0.3,第 6 篇自己建的 msgboard-net 是 172.18,Compose 建的 msgboard_default 又是另一個網段。IP 每次都可能不同,所以程式裡只寫服務名稱 db。要即時跟著看就加 -f(docker compose logs -f web),按 Ctrl + C 離開。

步驟 7:用服務名稱進資料庫

docker compose exec db mysql -u appuser -pAppPass123 msgboard

進去後查留言數,再 EXIT; 離開:

SELECT COUNT(*) FROM messages;
+----------+
| COUNT(*) |
+----------+
|        3 |
+----------+
1 row in set (0.00 sec)
docker compose exec db 進到 MySQL,SELECT COUNT(*) 查到 3 則留言

docker compose exec 對應第 2 篇的 docker exec -it,差別是後面寫服務名稱 db,不是容器名字。

步驟 8:改了程式,重建只動網頁

把網頁標題改成「部門留言板 v2」:

sed -i 's|<h1>部門留言板</h1>|<h1>部門留言板 v2</h1>|' app.py

(sed -i 是「直接在檔案裡找字串取代」,s|舊|新| 就是把舊的換成新的。)改完重建並啟動:

docker compose up -d --build
[+] Building 0.8s (12/12) FINISHED
(中間省略)
 => => transferring context: 10.18kB                                             0.0s
 => CACHED [2/5] WORKDIR /app                                                    0.0s
 => CACHED [3/5] COPY requirements.txt .                                         0.0s
 => CACHED [4/5] RUN pip install --no-cache-dir -r requirements.txt              0.0s
 => [5/5] COPY app.py .                                                          0.0s
(中間省略)
[+] up 3/3
 ✔ Image msgboard-web    Built      1.0s
 ✔ Container msgdb       Healthy   10.8s
 ✔ Container msgapp      Started   11.1s
docker compose up -d --build 只重做 COPY app.py 這一層,msgdb 沒被重建,msgapp 重新啟動

--build 是「先重新建置再啟動」。只有 [5/5] COPY app.py 重做,前面都用快取。msgdb 沒被重建(顯示 Healthy,沒有 Recreated),只有網頁容器換新。重新整理網頁:

重建後網頁標題變成部門留言板 v2,三則留言都還在,服務容器編號換成 1284c4463163

標題變了、留言還在、服務容器編號換成新的。這就是「換掉網頁那一層,資料那一層毫髮無傷」。

記法:改了 Compose 檔用 up -d,改了程式碼用 up -d --build。只打 up -d 而映像檔已經存在,Compose 不會重新建置,改的程式就不會生效。

步驟 9:stop、start、down,三種關法

先試 stop(只停不刪):

docker compose stop
docker ps -a
[+] stop 2/2
 ✔ Container msgapp Stopped    10.2s
 ✔ Container msgdb  Stopped     1.4s
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                        PORTS     NAMES
1284c4463163   msgboard-web   "python app.py"          58 seconds ago   Exited (137) 3 seconds ago              msgapp
a0a106752d8a   mysql:8.0      "docker-entrypoint.s…"   3 minutes ago    Exited (0) 1 second ago                 msgdb
docker compose stop 停掉兩個容器,msgapp 花 10.2 秒、Exited (137),msgdb 1.4 秒、Exited (0)

容器停了但還在(docker ps -a 看得到)。用 start 叫醒:

docker compose start
[+] start 2/2
 ✔ Container msgdb  Healthy   5.8s
 ✔ Container msgapp Started   0.3s
docker compose start 重新啟動,msgdb 5.8 秒 Healthy 後 msgapp 才 Started

再試 down(刪掉容器和網路),看看 Volume:

docker compose down
docker volume ls
[+] down 3/3
 ✔ Container msgapp          Removed   10.2s
 ✔ Container msgdb           Removed    1.7s
 ✔ Network msgboard_default  Removed    0.1s
DRIVER    VOLUME NAME
local     f1cbcedab6a41a27e388f4ef2e9d984b8f2fdbed0beb9a13a05c053f01706479
local     msgdb-data
docker compose down 刪掉兩個容器和 msgboard_default 網路,docker volume ls 顯示 msgdb-data 還在

容器、網路都刪了,msgdb-data 還在。(另一個亂碼名字的匿名 Volume 是第 6 篇失敗的 testdb 留下的。)一行開回來:

docker compose up -d
docker compose ps
[+] up 3/3
 ✔ Network msgboard_default  Created   0.0s
 ✔ Container msgdb           Healthy   5.9s
 ✔ Container msgapp          Started   6.1s
NAME     IMAGE          COMMAND                  SERVICE   CREATED          STATUS                     PORTS
msgapp   msgboard-web   "python app.py"          web       32 seconds ago   Up 25 seconds              0.0.0.0:8080->8080/tcp
msgdb    mysql:8.0      "docker-entrypoint.s…"   db        32 seconds ago   Up 31 seconds (healthy)    3306/tcp, 33060/tcp
docker compose up -d 重新建立網路和容器,6.1 秒整套回來,docker compose ps 兩個都在執行

6.1 秒整套回來,留言都還在。三種關法整理成表:

指令容器網路Volume(資料)什麼時候用
docker compose stop停止,保留保留保留暫時不用,等一下再開
docker compose down刪除刪除保留日常關機,最常用
docker compose down -v刪除刪除刪除想把資料庫清空重來

官方文件說明,down 預設只刪容器和網路;加 -v 才會刪 Compose 檔 volumes 區塊宣告的 Volume 和匿名 Volume。down -v 會讓資料庫內容消失、救不回來,在有真實資料的地方打這行就是事故,這篇沒有實際跑它。

stop、down、down -v 三種關法對照:容器、網路、Volume 各自會不會被刪

實測時的意外

1. YAML 用了 Tab,錯誤訊息不會說「Tab」

故意做一個用 Tab 縮排的檔案(printf 的 \t 就是 Tab),用 cat -A 把看不見的字元顯示出來,再讓 Compose 讀:

printf 'services:\n\tweb:\n\t\timage: nginx\n' > /tmp/bad.yml && cat -A /tmp/bad.yml
docker compose -f /tmp/bad.yml config
grep -P "\t" /tmp/bad.yml; echo "---"; grep -P "\t" docker-compose.yml; echo "沒有 Tab:$?"
services:$
^Iweb:$
^I^Iimage: nginx$
go-yaml load error in scanner (while scanning for the next token) at L2.C1: found character that cannot start any token
        web:
                image: nginx
---
沒有 Tab:1
用 printf 做出 Tab 縮排的 YAML,cat -A 顯示 ^I,docker compose config 報 found character that cannot start any token,grep -P 找出 Tab

cat -A 把 Tab 顯示成 ^I。錯誤訊息只說「第 2 行第 1 個字元(L2.C1)是不能當開頭的字元」,完全沒提到 Tab。遇到這句錯誤,九成是 Tab。檢查方法是 grep -P "\t" 檔名:有印出東西就代表有 Tab;我們的 docker-compose.yml 什麼都沒印、結束代碼是 1(代表找不到),所以沒有 Tab。

從網頁複製 YAML 也可能混進全形空格,看起來跟半形空格一樣,YAML 卻不認得。怎麼看都對卻一直報錯,就把那幾行刪掉重打。

2. .env 不見了,只會警告不會停

把 .env 暫時改名,再跑 config:

mv .env .env.bak && docker compose config 2>&1 | head -5; mv .env.bak .env
time="2026-10-06T08:17:16Z" level=warning msg="The \"MYSQL_ROOT_PASSWORD\" variable is not set. Defaulting to a blank string."
time="2026-10-06T08:17:16Z" level=warning msg="The \"MYSQL_DATABASE\" variable is not set. Defaulting to a blank string."
time="2026-10-06T08:17:16Z" level=warning msg="The \"MYSQL_USER\" variable is not set. Defaulting to a blank string."
time="2026-10-06T08:17:16Z" level=warning msg="The \"MYSQL_PASSWORD\" variable is not set. Defaulting to a blank string."
把 .env 改名後 docker compose config 出現 variable is not set. Defaulting to a blank string 警告

只是警告(warning),Compose 會把變數當成空字串繼續跑,結果就是 MySQL 沒密碼啟動失敗、或網頁連不上。看到 variable is not set 就檢查三件事:.env 在不在同一個資料夾、檔名是不是剛好叫 .env、等號前後有沒有多空格(要寫 KEY=value)。

3. 網頁容器每次停都要 10 秒

步驟 9 的 stop、down,msgapp 都花 10.2 秒、結束代碼 137,msgdb 只要 1.4 秒、結束代碼 0。步驟 8 的 up -d --build 也是同樣原因,msgapp 到 11.1 秒才 Started(要先花 10 秒停掉舊的)。

原因在第 4 篇講過:Flask 的 app.run() 當容器裡的第一個程式(PID 1)時,不會處理「請你結束」的訊號(SIGTERM),Docker 等滿 10 秒只好強制結束,137=128+9(被 9 號訊號 SIGKILL 強制關掉)。第 4 篇用 docker run --init 解決,Compose 也有對應的 init: true 設定(這篇沒有實測)。

4. 映像檔名字是 msgboard-web,不是 msgboard:v1

build: . 建出來的映像檔,Compose 自動取名「專案名稱-服務名稱」,所以是 msgboard-web:latest。要指定名字,可以在 web 底下同時寫 image: msgboard:v1,Compose 會用這個名字存建好的映像檔。


用完記得刪

docker compose ps
docker compose down
docker volume ls
NAME     IMAGE          COMMAND                  SERVICE   CREATED              STATUS                        PORTS
msgapp   msgboard-web   "python app.py"          web       About a minute ago   Up About a minute             0.0.0.0:8080->8080/tcp
msgdb    mysql:8.0      "docker-entrypoint.s…"   db        About a minute ago   Up About a minute (healthy)   3306/tcp, 33060/tcp
[+] down 3/3
 ✔ Container msgapp          Removed   10.2s
 ✔ Container msgdb           Removed    0.7s
 ✔ Network msgboard_default  Removed    0.1s
DRIVER    VOLUME NAME
local     f1cbcedab6a41a27e388f4ef2e9d984b8f2fdbed0beb9a13a05c053f01706479
local     msgdb-data
收尾:docker compose down 刪掉容器和網路,docker volume ls 確認 msgdb-data 保留

看一下 Docker 總共佔了多少空間:

docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          5         0         1.412GB   1.195GB (84%)
Containers      0         0         0B        0B
Local Volumes   2         0         197MB     197MB (100%)
Build Cache     42        1         374.1MB   102.7MB
docker system df 顯示映像檔 1.412GB、可回收 1.195GB(84%),Volume 197MB

(截圖裡指令後面還接了 ls -la 列出檔案,這裡省略。)RECLAIMABLE 是「可以清掉的空間」:映像檔 1.412GB 裡有 1.195GB 沒被任何容器使用,1.195 ÷ 1.412 ≈ 84%。Cloud Shell 的家目錄只有 5 GB,這個數字變大就該清了。

不再需要這套留言板的話:第 6 篇建的 msgboard-net 網路用 docker network rm msgboard-net 刪;資料也不要了,再用第 5 篇教的 docker volume rm msgdb-data。Cloud Shell 免費,不清不會被收費。


到了 GCP 上叫什麼

這篇的觀念Cloud RunGKE(Kubernetes)
一份檔案描述整套服務可以用 gcloud run compose up compose.yaml 直接部署(官方文件,2026 年 11 月查),但只支援部分欄位用一組 YAML(Deployment、Service)描述,kubectl apply -f 套用
服務名稱就是位址Compose 部署會變成一個 Cloud Run 服務、裡面好幾個容器Service 名稱由叢集 DNS 解析,概念一樣
depends_on+healthcheck官方支援清單有 depends_on(決定容器啟動順序),沒有列 healthcheck沒有 depends_on,改用就緒探針(readiness probe),第 17 篇會講
MySQL 容器+Volume資料庫通常改用代管的 Cloud SQL可以用 StatefulSet+PVC,也常改用 Cloud SQL
.env 裡的密碼放進 Secret Manager放進 K8s 的 Secret,第 15 篇會講

官方文件也提醒:用 Compose 部署到 Cloud Run 的服務,預設最多只有 1 個執行個體,而且它不是正式環境「基礎架構即程式碼」的替代品。比較適合把開發好的東西快速丟上去試,正式環境還是用 Cloud Run 本身的設定或 Terraform 管理。


面試/證照會怎麼問

面試常見題

題目回答重點
Dockerfile 和 Compose 檔差在哪?Dockerfile 定義一個映像檔怎麼建;Compose 檔定義多個容器怎麼一起跑(網路、Volume、環境變數、啟動順序)
docker-compose 和 docker compose 差在哪?前者是 v1(Python),已不再維護;後者是 v2 起的 Docker 外掛(2025 年起版本號是 v5),現在的標準寫法
depends_on 能保證資料庫準備好嗎?簡單寫法只保證容器開了;要搭配 healthcheck 和 condition: service_healthy 才會等服務真的就緒
有了 depends_on,程式還需要重試機制嗎?需要。資料庫可能執行中斷線,而且部署到 Kubernetes、Cloud Run 時沒有 depends_on
down 和 down -v 差在哪?down 刪容器和網路、保留 Volume;-v 連 Volume 一起刪,資料會消失
Compose 適合正式環境嗎?單機的開發、測試、小型內部系統很適合;跨多台機器、自動擴展、自動修復要用 Kubernetes
密碼怎麼管?放 .env,Compose 檔用 ${變數};.env 加進 .gitignore 和 .dockerignore,另附 .env.example

Kubernetes 證照(CKAD、CKA)

CKAD、CKA 不考 Docker Compose,但 Compose 的每個欄位在 Kubernetes 都有對應:services 變成 Deployment+Service、environment 變成 env 和 ConfigMap、.env 的密碼變成 Secret、healthcheck 變成 Probe。兩張證照都是上機實作考,要在 2 小時內用指令和 YAML 完成任務(Linux Foundation 官方頁,2026 年 11 月查:費用 445 美元、含 1 次補考、效期 2 年),YAML 的縮排功力在考場上非常重要。

看到這些字,就想到這個

題目出現的字想到
「一個指令啟動多個容器」「本機開發環境」Docker Compose
「等資料庫就緒才啟動」healthcheck+depends_on: condition: service_healthy
「found character that cannot start any token」YAML 裡有 Tab
「variable is not set. Defaulting to a blank string」.env 沒讀到
「改了程式碼沒生效」少了 --build
「the attribute version is obsolete」刪掉 Compose 檔開頭的 version:

常見問答

docker compose 和 docker-compose 有什麼差別?

docker-compose(有連字號)是 Python 寫的 Compose v1,官方已經不再維護;docker compose(空格)是 2020 年起用 Go 重寫的外掛版本,2025 年版本號從 v2 直接跳到 v5,功能相同。新專案一律用 docker compose,2026 年 11 月 Cloud Shell 內建的是 v5.7.1。

docker-compose.yml 開頭還需要寫 version 嗎?

不需要。Docker 官方文件說明,頂層的 version 欄位只剩參考用途,寫了會收到「已過時(obsolete)」的警告,Compose 一律用最新的格式規範來檢查檔案。看到教學範例第一行還寫 version: “3.8”,直接刪掉那一行就好。

Compose 檔要叫 compose.yaml 還是 docker-compose.yml?

兩個都可以。官方預設優先找 compose.yaml(或 compose.yml),為了相容舊版也認得 docker-compose.yaml 和 docker-compose.yml。新專案建議用 compose.yaml;舊專案沿用 docker-compose.yml 也能正常運作,這篇的實測就是用舊檔名。

docker compose down 會刪掉資料嗎?

預設不會。docker compose down 只刪除容器和 Compose 建立的網路,Volume 會保留,下次 up 資料都還在(這篇實測留言都還在)。加上 -v 才會連 Compose 檔裡宣告的 Volume 和匿名 Volume 一起刪掉,資料庫內容會消失。

depends_on 能保證資料庫已經準備好了嗎?

只寫 depends_on: – db 不行,它只保證 db 容器已經啟動,MySQL 可能還在初始化。要在 db 加上 healthcheck,並把 depends_on 寫成 condition: service_healthy,Compose 才會等健康檢查通過才啟動網頁容器。程式本身最好還是保留重試機制。

改了程式碼,docker compose up -d 為什麼沒有生效?

因為映像檔已經存在時,docker compose up -d 不會重新建置,跑的還是舊的映像檔。改了程式碼要用 docker compose up -d –build,Compose 會重新建置有變動的服務,沒變的服務(例如資料庫)不會被重建。

.env 檔可以放進 Git 嗎?

不行。.env 裡是真實密碼,放上 Git 等於公開給所有看得到這個儲存庫的人。做法是把 .env 加進 .gitignore 和 .dockerignore,另外提供一份裝假密碼的 .env.example,新同事複製成 .env 再填自己的值。


重點整理

  • Compose 用一個 YAML 檔描述多個容器:docker compose up -d 一行開起來,down 一行關掉,取代第 6 篇二十幾行的 docker run
  • 新寫法:指令是 docker compose(v1 的 docker-compose 已不再維護,現在的版本號是 v5)、檔案開頭不用寫 version:、新專案檔名用 compose.yaml
  • 服務名稱就是位址:Compose 自動建「專案名稱_default」網路,DB_HOST: db 就連得到
  • 真的等資料庫好:healthcheck+depends_on: condition: service_healthy,實測 db 6.0 秒 Healthy 後 web 才在 6.2 秒啟動
  • 三種關法:stop 保留一切、down 刪容器和網路但留資料、down -v 連資料一起刪;改程式碼要 up -d --build

延伸閱讀

本系列

站上相關文章


把整套系統寫成一份檔案,環境才真的能交接、能重現。如果你想有系統地從容器一路學到在 Google Cloud 上部署服務,可以看看東東的 GCP 課程,或加 LINE 聊聊你現在的狀況,一起找出最適合你的學習順序。

Table of Contents
返回頂端