專案概述

這是一套針對開發團隊設計的 Docker 容器化工具集，提供統一的本地開發環境。 透過預先配置的 Compose 模板與自動化腳本，降低「在我的機器上可以跑」的問題。

注意事項

此工具集需要 Docker Engine 24+ 與 Docker Compose v2。 請確保本機已安裝對應版本。

功能特色

• 一鍵啟動完整開發環境
• 多服務 docker-compose 模板
• 環境變數管理（.env 範本自動產生）
• 自動化健康檢查與重啟機制
• 開發 / 測試 / 生產環境設定檔分離

快速開始

1. 複製專案

   git clone https://github.com/example/docker-toolkit.git
   cd docker-toolkit

2. 初始化環境變數

   cp .env.example .env

3. 啟動服務

   docker compose up -d

4. 確認服務狀態

   docker compose ps

環境配置

開發環境

docker-compose.dev.yml

services:
  app:
    build:
      context: .
      target: development
    volumes:
      - .:/app
      - /app/node_modules
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development

生產環境

docker-compose.prod.yml

services:
  app:
    build:
      context: .
      target: production
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3

專案結構

• 資料夾docker-toolkit/

  • docker-compose.yml
  • docker-compose.dev.yml
  • docker-compose.prod.yml
  • .env.example
  • 資料夾scripts/

    • init.sh
    • health-check.sh
    • backup.sh
  • 資料夾templates/

    • nginx.conf
    • Dockerfile.node
    • Dockerfile.python

相關頁面

• Felimet Hub 網站 — 使用本工具集進行容器化部署的專案之一
• Docker 指南 — Docker 基礎概念與常用指令筆記
• Kubernetes 入門 — 容器編排進階知識，搭配本工具集使用