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 篇的留言板做,沒做過也沒關係,下面會說怎麼補。

為什麼你需要知道
- 多容器的指令記不住:資料庫要掛哪個路徑、環境變數叫什麼、誰要先開,全靠記憶,換一台機器或過三個月就忘了
- 新同事要花半天建環境:有了 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 up | docker compose up |
| 版本號 | v1(已不再維護) | v2 之後;2025 年起是 v5 |
| 檔案開頭 | version: "3.8" | 不用寫,寫了會跳過時警告 |
| 預設檔名 | docker-compose.yml | compose.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/

有 .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 篇的指令逐項對照:

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

config 會印出展開後的完整設定,從這裡可以確認三件事:
DB_PASSWORD: AppPass123:${MYSQL_PASSWORD}已經被換成.env裡的值,代表.env有讀到name: msgboard_default:Compose 會自動建的網路叫這個名字。官方文件說明,沒特別指定的話,專案名稱就是 Compose 檔所在的資料夾名稱,這裡是msgboardrequired: 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

最後 4 行就是 Compose 幫你做的事:
| Compose 自動做的 | 第 6 篇你手動做的 |
|---|---|
Image msgboard-web Built | docker build -t msgboard:v1 . |
Network msgboard_default Created | docker 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

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

第 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.

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

注意 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 對應第 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

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

標題變了、留言還在、服務容器編號換成新的。這就是「換掉網頁那一層,資料那一層毫髮無傷」。
記法:改了 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 ps -a 看得到)。用 start 叫醒:
docker compose start
[+] start 2/2
✔ Container msgdb Healthy 5.8s
✔ Container msgapp Started 0.3s

再試 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

容器、網路都刪了,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

6.1 秒整套回來,留言都還在。三種關法整理成表:
| 指令 | 容器 | 網路 | Volume(資料) | 什麼時候用 |
|---|---|---|---|---|
docker compose stop | 停止,保留 | 保留 | 保留 | 暫時不用,等一下再開 |
docker compose down | 刪除 | 刪除 | 保留 | 日常關機,最常用 |
docker compose down -v | 刪除 | 刪除 | 刪除 | 想把資料庫清空重來 |
官方文件說明,down 預設只刪容器和網路;加 -v 才會刪 Compose 檔 volumes 區塊宣告的 Volume 和匿名 Volume。down -v 會讓資料庫內容消失、救不回來,在有真實資料的地方打這行就是事故,這篇沒有實際跑它。

實測時的意外
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

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."

只是警告(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 總共佔了多少空間:
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

(截圖裡指令後面還接了 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 Run | GKE(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
延伸閱讀
本系列
- 第 1 篇:Docker 入門教學:不用安裝,用 Cloud Shell 跑出第一個容器
- 第 2 篇:Docker 常用指令一次看懂:run、ps、logs、exec、stop、rm
- 第 4 篇:Dockerfile 怎麼寫?從零打包你的第一個網頁映像檔
- 第 5 篇:Docker 資料會消失?Volume 和 Bind Mount 怎麼選
- 上一篇:第 6 篇:容器之間怎麼連線?Docker Network 與 Port 對應實作
- 下一篇:第 8 篇:映像檔太肥怎麼辦?Docker 多階段建置與 .dockerignore
站上相關文章
- 容器 (Container) 技術是什麼?從零開始看懂 Docker 與容器化應用
- Kubernetes 是什麼?白話解釋 + 判斷你是否真的需要它
- Cloud Run 讀取 Secret Manager
- Cloud Run 簡介與手把手教學
把整套系統寫成一份檔案,環境才真的能交接、能重現。如果你想有系統地從容器一路學到在 Google Cloud 上部署服務,可以看看東東的 GCP 課程,或加 LINE 聊聊你現在的狀況,一起找出最適合你的學習順序。