最後活躍 5 months ago

這個 Makefile 讓 Docker Compose 專案管理變超簡單!它會自動用資料夾名稱當專案名。你可以用它來啟動、停止、重啟服務,也能輕鬆備份和還原 PostgreSQL 資料庫(還原是「砍掉重練」等級,要小心用喔!)。它還能幫你清理 Docker 資源,解決一些「技術債」。配合 `docker-compose.yml`,資料庫服務設定好好的,資料會自動存起來,連初始化腳本的換行符號都會自動搞定,超貼心!

修訂 f9b2084d06b51e9b4261bf953669efd775b0e3b9

docker-compose.yml 原始檔案
1db:
2 image: postgres:15 # 使用 PostgreSQL 15 版的 Docker 映像檔
3 container_name: app_db # 設定容器名稱,方便辨識
4 environment:
5 POSTGRES_USER: ${DB_USER:-postgres} # 資料庫使用者帳號,可由 DB_USER 環境變數指定,預設為 'postgres'
6 POSTGRES_DB: ${DB_NAME:-app_db} # 資料庫名稱,可由 DB_NAME 環境變數指定,預設為 'app_db'
7 POSTGRES_PASSWORD: ${DB_PASSWORD:-password} # 資料庫密碼,可由 DB_PASSWORD 環境變數指定,預設為 'password'
8 healthcheck: # 健康檢查設定,確認資料庫服務是否正常運作
9 test: [ "CMD-SHELL", "pg_isready -d ${DB_NAME:-app_db} -U ${DB_USER:-postgres}" ] # 檢查資料庫是否可連線,使用預設或指定的資料庫/使用者
10 interval: 10s # 每 10 秒檢查一次
11 timeout: 5s # 每次檢查的逾時時間
12 retries: 5 # 失敗重試次數
13 restart: unless-stopped # 容器停止後自動重啟,除非手動停止
14 networks:
15 - app_network # 將此容器加入 app_network 網路,方便與其他服務溝通
16 volumes:
17 - app_postgres_data:/var/lib/postgresql/data # 將資料庫數據持久化到 Docker Volume,避免容器移除後資料遺失
18 - type: bind # 使用 bind mount 方式掛載
19 source: ./database_init # 掛載本機端 ./database_init 資料夾 (請確保你的初始化腳本放在此處)
20 target: /docker-entrypoint-initdb.d # 掛載到容器內 PostgreSQL 啟動時會自動執行 SQL/Shell 腳本的目錄
21 consistency: cached # 快取一致性模式,提升效能
22 command: > # 容器啟動時執行的命令,用於處理初始化腳本的換行符號及權限
23 bash -c ' if command -v apt-get >/dev/null 2>&1; then # 檢查是否為 Debian/Ubuntu 系列系統
24 apt-get update && apt-get install -y dos2unix # 安裝 dos2unix 工具
25 elif command -v apk >/dev/null 2>&1; then # 檢查是否為 Alpine 系列系統
26 apk add --no-cache dos2unix # 安裝 dos2unix 工具
27 fi && find /docker-entrypoint-initdb.d -type f -name "*.sh" -exec sh -c '\'' # 尋找初始化目錄下的 .sh 腳本
28 dos2unix "{}" 2>/dev/null || true # 轉換 Windows 換行符號為 Unix 格式 (忽略錯誤)
29 chmod +x "{}" # 賦予腳本執行權限
30 '\'' \; && exec docker-entrypoint.sh postgres ' # 執行 PostgreSQL 官方的入口點腳本
31
32volumes:
33 app_postgres_data: # 定義一個名為 app_postgres_data 的 Docker Volume,用來儲存 PostgreSQL 資料
34
35networks:
36 app_network: # 定義一個名為 app_network 的 Docker 網路,用於服務間的內部通訊