Docker, 標準 docker-compose.yml 範例
docker-compose.yml
services:
# 1. 後端應用程式服務
webapp:
image: python:3.12-slim
container_name: week11_webapp
working_dir: /app
volumes:
- ./app:/app
command: sh -c "pip install -q mysql-connector-python redis && python app.py"
ports:
- "8080:8000"
environment:
- DB_HOST=db
- REDIS_HOST=redis
depends_on:
- db
- redis
restart: unless-stopped
# 2. 關聯式資料庫 (不對外開放 ports,僅限內部網路存取)
db:
image: mariadb:11
container_name: week11_mariadb
environment:
- MARIADB_ROOT_PASSWORD=RootSecret2026!
- MARIADB_DATABASE=webapp_db
- MARIADB_USER=webapp_user
- MARIADB_PASSWORD=StrongP@ssw0rd2026!
volumes:
- mariadb_data:/var/lib/mysql
restart: unless-stopped
# 3. 記憶體快取服務 (不對外開放 ports)
redis:
image: redis:7-alpine
container_name: week11_redis
command: redis-server --requirepass RedisSuperSecret2026!
restart: unless-stopped
# 宣告具名 Volume 確保資料庫資料持久化
volumes:
mariadb_data:
標準的 docker-compose.yml 採用 YAML 格式撰寫,核心結構由 services(服務)、networks(網路)與 volumes(資料卷)三大區塊組成(現代 Docker Compose V2 規範已不再強制要求填寫最上方的 version 標籤)
以下提供一份涵蓋後端應用與資料庫的標準範本與語法說明:
services:
# 1. 應用程式服務(自訂服務名稱)
web:
build:
context: . # Dockerfile 所在路徑
dockerfile: Dockerfile # 指定 Dockerfile 名稱
container_name: my-web-app # 指定容器名稱
restart: unless-stopped # 重啟策略(除非手動停止,否則自動重啟)
ports:
- "8080:80" # 連接埠映射(主機Port:容器Port)
environment: # 環境變數設定
- TZ=Asia/Taipei
- DB_HOST=db
env_file:
- .env # 從外部 .env 檔案載入環境變數
volumes:
- ./app:/app # 綁定掛載(開發時同步本機程式碼)
depends_on: # 啟動順序依賴
- db
networks:
- app-network # 加入自訂網路
# 2. 資料庫服務
db:
image: postgres:16-alpine # 直接使用 Docker Hub 官方映像檔
container_name: my-postgres
restart: always
environment:
POSTGRES_USER: admin
POSTGRES_PASSWORD: secret
POSTGRES_DB: mydb
volumes:
- db-data:/var/lib/postgresql/data # 具名資料卷(確保資料持久化)
networks:
- app-network
# 3. 定義自訂網路
networks:
app-network:
driver: bridge # 預設橋接網路模式
# 4. 定義具名資料卷
volumes:
db-data:
核心語法與參數說明
- 縮排規則:YAML 嚴格依賴空白鍵縮排(通常為 2 個空白),不可使用
Tab鍵,否則會報錯 services:定義各個獨立的容器元件,每個子項目(如上述的web、db)都是一個容器image/build:二擇一。image直接拉取現成映像檔;build則從本地的Dockerfile建置映像檔ports:格式為"外部主機埠:內部容器埠",建議加上雙引號避免 YAML 將冒號誤判為時間格式volumes:分為「綁定掛載(./本機路徑:/容器路徑)」與「具名資料卷(卷名稱:/容器路徑)」。資料庫強烈建議使用具名資料卷,避免容器刪除後資料遺失。depends_on:控制容器的啟動先後順序(例如先啟動db再啟動web)
networks:建立隔離的虛擬網路。同一個網路內的服務可以直接透過服務名稱(如db)作為主機名稱(Hostname)互相連線,無須查詢 IPvolumes:集中宣告需要持久化保存的具名資料卷,執行docker compose down時會保留資料,除非額外加上-v參數才會一併清除