ClusterShell 簡介
ClusterShell (clush) 是輕量級並行分散式 Shell 工具,透過 SSH 同時在多台伺服器執行指令、複製檔案、收集輸出,適合叢集管理、批次部署、效能採集。
安裝部署
套件管理器 (推薦)
# CentOS/RHEL (EPEL)
yum install epel-release -y
yum install clustershell -y
# Ubuntu/Debian
apt update && apt install clustershell -y
# Fedora
dnf install clustershell -y
源碼安裝
wget https://github.com/cea-hpc/clustershell/archive/refs/tags/v1.8.3.tar.gz
tar xzf v1.8.3.tar.gz
cd clustershell-1.8.3
python3 setup.py install
# 複製配置範例
mkdir -p /etc/clustershell
cp conf/* /etc/clustershell/
核心配置:節點群組定義 (/etc/clustershell/groups)
# 格式: 群組名: 節點列表 (支援範圍展開、排除、嵌套)
# 節點名稱需可解析 (DNS/hosts) 或為 IP
# 資料庫叢集
db: db-[01-03],db-[05-06]
db_master: db-01
db_slave: db-[02-03],db-[05-06]
# Web 叢集
web: web-[01-10]
web_frontend: web-[01-03]
web_backend: web-[04-10]
# 所有生產機器
prod: @db,@web,app-[01-05],lb-[01-02]
# 排除節點
prod_no_db: @prod,!@db
# 變數替換 (在 group.conf 定義)
# [main]
# node_re = ^(.+)-(\d+)$
免密碼 SSH 前置需求 (關鍵)
# 1. 管理節點生成金鑰 (若無)
ssh-keygen -t ed25519 -C "clustershell-admin"
# 2. 分發公鑰至所有目標節點
# 方法一:ssh-copy-id 逐台 (少量)
for host in db-01 db-02 db-03; do ssh-copy-id $host; done
# 方法二:ClusterShell 並行分發 (大量)
# 需先配置 groups,使用 root 或具 sudo 權限帳號
clush -a -b --copy ~/.ssh/id_ed25519.pub --dest ~/.ssh/authorized_keys_import
clush -a -b "cat ~/.ssh/authorized_keys_import >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
# 3. 驗證免密登入
clush -a -b "hostname"
常用 clush 指令實戰
| 需求 | 指令 | 說明 |
| 所有 DB 節點執行 uptime | clush -b -g db "uptime" | -b 合併相同輸出,-g 指定群組 |
| 所有節點檢查磁碟使用率 | clush -a "df -h | grep -v tmpfs" | -a 所有群組節點 |
| 複製本地檔案至所有 Web 節點 | clush -g web --copy /etc/nginx/nginx.conf --dest /etc/nginx/ | --copy/--dest 並行分發 |
| 從所有節點收集檔案 | clush -g db --rcopy /var/log/mysql/slow.log --dest /tmp/logs/ | --rcopy 遠端複製回本地 |
| 互動式並行 Shell | clush -g db -b -i | -i 互動模式,輸入指令在所有節點執行 |
| 指定用戶/連接埠/逾時 | clush -g prod -l admin -p 2222 -t 30 "cmd" | -l 用戶, -p 連接埠, -t 逾時秒數 |
| 排除特定節點 | clush -g prod -x db-02,web-05 "cmd" | -x 排除節點 |
| 串流模式 (即時輸出) | clush -g db -S "tail -f /var/log/messages" | -S 串流輸出,適合即時日誌 |
進階:節點集合運算與動態群組
# 查看群組展開
nodeset -e @db
# db-01 db-02 db-03 db-05 db-06
# 交集/聯集/差集
nodeset -i @web,@prod # 交集
nodeset -u @web,@db # 聯集
nodeset -d @prod,@db # 差集 (prod 但非 db)
# 動態從檔案/命令產生群組
clush -w $(cat /tmp/target_hosts.txt) "cmd"
clush -w $(aws ec2 describe-instances --filters ... --query 'Reservations[].Instances[].PrivateDnsName' --output text) "cmd"
輸出格式控制
# 預設:節點名: 輸出
clush -g db "hostname"
# 合併相同輸出 (-b)
clush -b -g db "hostname"
# db-[01-03,05-06]: hostname_output
# 只顯示節點名 (-q 安靜模式)
clush -q -g db "hostname" # 僅顯示節點名,不顯示輸出
# JSON 輸出 (程式解析)
clush --json -g db "uptime"
與 Ansible/Puppet/Salt 對比
| 特性 | ClusterShell | Ansible | Puppet/Salt |
| 架構 | 無代理,SSH 推送 | 無代理,SSH 推送 | 代理/無代理 |
| 配置管理 | 無 (指令執行) | 聲明式 Playbook | 聲明式 Manifest/State |
| 冪等性 | 無 | 有 | 有 |
| 適用場景 | 臨時指令、採集、應急、輕量自動化 | 配置部署、編排、CI/CD | 大規模配置管理、合規 |
| 學習曲線 | 極低 | 中 | 高 |
最佳實踐建議
- **管理節點專用**:建立專用管理帳號 (如
clushadmin),配置 sudo NOPASSWD 僅限必要指令
- **群組分層**:環境 (prod/staging) → 角色 (db/web/app) → 功能 (master/slave)
- **配置版控**:
/etc/clustershell/ 納入 Git 管理
- **審計日誌**:Wrapper 腳本記錄
who、when、what、where
- **結合監控**:定時
clush -a "metrics_collector" 採集推送至 Prometheus/InfluxDB