Blog Details

Linux 作業系統 cutexyz > Blog > Docker > Docker, 標準 docker-compose.yml 範例

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)互相連線,無須查詢 IP
  • volumes:集中宣告需要持久化保存的具名資料卷,執行 docker compose down 時會保留資料,除非額外加上 -v 參數才會一併清除

Leave A Comment

All fields marked with an asterisk (*) are required