這是本文件的舊版！
Docker Swarm (Docker 多主機方案)
- 因進入 Kubernetes 的學習門檻高, 以及需要較高規格的硬體資源議題, 因此快速安裝測試 Docker Swarm 方案.
安裝與部署
- 確保每一台已經安裝好 docker 環境且每台之間都可以透過 TCP port 2377 互相溝通
- 選定一台當主控點 Exp. 192.168.11.186
- 登入到 192.168.11.186
- 執行初始化指令
docker swarm init --advertise-addr 192.168.11.186 - 將回應的訊息記錄下來 Exp.
docker swarm join --token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk7434l103e8k2d6x 192.168.11.186:2377
- 將三台 docker 環境加入成為 swarm 的 Worker Exp. 192.168.11.182, 192.168.11.237, 192.168.11.195
- 登入到 192.168.11.182, 192.168.11.237, 192.168.11.195
- 貼上並執行加入指令 (請使用您自己產生的 Token 和 IP)
docker swarm join --token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk7434l103e8k2d6x 192.168.11.186:2377
- 回到主控點上 Exp. 192.168.11.186 查看狀態
docker node ls
使用 portainer 進行 Web 統一控管
- 在主控點安裝 Portainer (參考 在 Alpine 內安裝 Portainer 管理 Container)
- 系統管理權限登入 Portainer UI → Home → Environment-related → Environments → Add environment
- 在主控點安裝 Agent (直接貼上這段即可)
- 當 Agent 安裝成功後, 回到 WebUI 輸入主控點的 Name (Exp. Portainer-186) 與 address (Exp. 192.168.1.186:9001), 然後點下 Connect 按鈕就可以建立完成
- 回到 Home 在 Environments 清單就可以看到 Portainer-186 , 點下去就可以開始管理這個 Swarm cluster
建立 watchtower 統一在主控點進行管理
- 可以直接在主控點下以下的命令建立 docker service
docker service create \ --name watchtower \ --mode global \ --constraint 'node.role == manager' \ --mount type=bind,source=/var/run/docker.sock,destination=/var/run/docker.sock \ containrrr/watchtower \ --cleanup \ --scope swarm
FAQ
1. 移除特定 Worker host 方式 Exp. immich-237
- 進入主控點主機執行
- 將 immich-237 設為 drain (暫停提供服務)
docker node update --availability drain immich-237 - 確認 immich-237 的 AVAILABILITY 已經由 Active → Drain , STATUS 已經由 Ready → Down
docker node ls - 移除 immich-237 這 Worker host
docker node rm immich-237
- 進入要移除的 Worker 執行 (immich-237)
- 執行離開 swarm 指令
docker swarm leave
2. 建立擴充至三台當主控點
- 將叢集中一台已經是工作節點 (Worker) 的主機，提升 (Promote) 為主控點。
- 確保您現有的 Swarm 叢集運作正常，主控點處於 Ready 狀態。
- 奇數原則：為了維持 Quorum 機制的穩定性，強烈建議主控點的總數為奇數（例如 3、5、7…）。如果您目前只有 1 台，那麼增加 2 台湊成 3 台是最好的做法。如果您目前已有 2 台，建議再增加 1 台湊成 3 台。
- 至現有的主控點執行
- 列出目前 Worker 清單
docker node lsportainer-186:~# docker node ls ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION ramtv89mfx2vcrekm7lsoobt8 moon-tv-195 Ready Active 28.3.3 318i734m5zx0w6iqe1q2ddijm * portainer-186 Ready Active Leader 28.3.3 i9zyahgszt2awip7dl1tckyz8 sbom-182 Ready Active 28.3.3 lxftp7j4emal33f81vmywtxaz swarm-225 Ready Active 28.3.3 q4fxgqgi2sp42wntxynks3wqf swarm-226 Ready Active 28.3.3
- 將 swarm-225 與 swarm-226 升級成主控點
docker node promote swarm-225 docker node promote swarm-226
- 確認升級結果
docker node lsportainer-186:~# docker node ls ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION ramtv89mfx2vcrekm7lsoobt8 moon-tv-195 Ready Active 28.3.3 318i734m5zx0w6iqe1q2ddijm * portainer-186 Ready Active Leader 28.3.3 i9zyahgszt2awip7dl1tckyz8 sbom-182 Ready Active 28.3.3 lxftp7j4emal33f81vmywtxaz swarm-225 Ready Active Reachable 28.3.3 q4fxgqgi2sp42wntxynks3wqf swarm-226 Ready Active Reachable 28.3.3