シェルスクリプトで複数サーバーへのSSH並列実行を設計する方法｜結果集約とエラー検知の実践パターン

この記事のポイント

・&とwait ${PIDS[$i]}でSSH接続を並列化して終了コードを個別収集できる
・mktemp + trap EXITで一時ファイルを確実にクリーンアップする設計が基本
・timeoutとConnectTimeoutの2段階で応答しないサーバーへの待ちを制限する
・障害サーバーを自動検知してFAILEDカウントをexit値として返す設計が推奨

#!/bin/bash
set -uo pipefail

SERVERS=("srv01.example.local" "srv02.example.local" "srv03.example.local")

for SERVER in "${SERVERS[@]}"; do
  # -n: バックグラウンド実行時の標準入力リダイレクト（必須）
  ssh -n -o ConnectTimeout=5 "$SERVER" "df -h /" &
done

wait
echo "全サーバーの処理が完了しました"

#!/bin/bash
set -uo pipefail   # -e は意図的に外す（後述）

SERVERS=("srv01.example.local" "srv02.example.local" "srv03.example.local")
declare -a PIDS=()

# バックグラウンドでSSHを起動してPIDを記録する
for SERVER in "${SERVERS[@]}"; do
  ssh -n -o ConnectTimeout=5 "$SERVER" "df -h /" &
  PIDS+=($!)       # $! は直前のバックグラウンドジョブのPID
done

# 各PIDの終了コードを個別に収集する
FAILED=0
for i in "${!PIDS[@]}"; do
  wait "${PIDS[$i]}"   # このwaitは対象PIDの終了コードを返す
  RC=$?
  SERVER="${SERVERS[$i]}"
  if [ "$RC" -ne 0 ]; then
    echo "[FAIL] ${SERVER} (終了コード: ${RC})"
    FAILED=$((FAILED + 1))
  else
    echo "[OK]   ${SERVER}"
  fi
done

echo "---"
echo "完了: ${#SERVERS[@]} サーバー中 $FAILED 件失敗"
exit $FAILED

#!/bin/bash
set -uo pipefail

SERVERS=("srv01.example.local" "srv02.example.local" "srv03.example.local")
declare -a PIDS=()

# 一時ディレクトリを作成してEXIT時に自動削除する
WORKDIR=$(mktemp -d /tmp/ssh_parallel.XXXXXX)
trap 'rm -rf "$WORKDIR"' EXIT

for SERVER in "${SERVERS[@]}"; do
  ssh -n -o ConnectTimeout=5 "$SERVER" "df -h / | tail -1"     > "$WORKDIR/${SERVER}.out"     2> "$WORKDIR/${SERVER}.err" &
  PIDS+=($!)
done

FAILED=0
for i in "${!SERVERS[@]}"; do
  wait "${PIDS[$i]}"
  RC=$?
  SERVER="${SERVERS[$i]}"
  if [ "$RC" -eq 0 ]; then
    printf "[OK]   %-30s %s\n" "$SERVER" "$(cat "$WORKDIR/${SERVER}.out")"
  else
    printf "[FAIL] %-30s %s\n" "$SERVER" "$(cat "$WORKDIR/${SERVER}.err")"
    FAILED=$((FAILED + 1))
  fi
done

echo "---"
echo "完了: ${#SERVERS[@]} サーバー中 $FAILED 件失敗"
exit $FAILED

# ConnectTimeout=5 で接続確立を5秒以内に制限
# timeout 10 でSSH全体（接続+コマンド実行）を10秒以内に制限
# BatchMode=yes でパスワードプロンプトを出さず即座に失敗させる
timeout 10 ssh -n \
  -o ConnectTimeout=5 \
  -o StrictHostKeyChecking=no \
  -o BatchMode=yes \
  "$SERVER" "df -h / | tail -1" \
  > "$WORKDIR/${SERVER}.out" \
  2> "$WORKDIR/${SERVER}.err" &
PIDS+=($!)

#!/bin/bash
# disk-check-all.sh - 全サーバーのディスク使用量を並列確認する
set -uo pipefail

# 管理対象サーバーリスト
SERVERS=(
  "srv01.example.local"
  "srv02.example.local"
  "srv03.example.local"
  "srv04.example.local"
  "srv05.example.local"
)

CONNECT_TIMEOUT=5   # TCP接続の最大待ち秒数
EXEC_TIMEOUT=10     # SSHコマンド全体の最大待ち秒数
WARN_PERCENT=80     # 使用率がこの値以上なら警告表示する

declare -a PIDS=()
WORKDIR=$(mktemp -d /tmp/disk_check.XXXXXX)
trap 'rm -rf "$WORKDIR"' EXIT

echo "=== ディスク使用量チェック開始 ($(date '+%Y-%m-%d %H:%M:%S')) ==="

# 全サーバーへ並列でSSH接続する
for SERVER in "${SERVERS[@]}"; do
  timeout "$EXEC_TIMEOUT" ssh -n \
    -o "ConnectTimeout=${CONNECT_TIMEOUT}" \
    -o StrictHostKeyChecking=no \
    -o BatchMode=yes \
    "$SERVER" \
    "df -h / | awk 'NR==2{print \$5, \$1, \$2, \$3, \$4}'" \
    > "$WORKDIR/${SERVER}.out" \
    2> "$WORKDIR/${SERVER}.err" &
  PIDS+=($!)
done

# 結果を収集して表示する
FAILED=0
WARN=0
for i in "${!SERVERS[@]}"; do
  wait "${PIDS[$i]}"
  RC=$?
  SERVER="${SERVERS[$i]}"

  if [ "$RC" -ne 0 ]; then
    printf "[FAIL] %-28s %s\n" "$SERVER" "$(cat "$WORKDIR/${SERVER}.err")"
    FAILED=$((FAILED + 1))
    continue
  fi

  USAGE=$(cat "$WORKDIR/${SERVER}.out")
  PERCENT=$(echo "$USAGE" | awk '{print $1}' | tr -d '%')

  if [ "$PERCENT" -ge "$WARN_PERCENT" ]; then
    printf "[WARN] %-28s %s  <- 使用率 %s%%\n" "$SERVER" "$USAGE" "$PERCENT"
    WARN=$((WARN + 1))
  else
    printf "[OK]   %-28s %s\n" "$SERVER" "$USAGE"
  fi
done

echo "==="
echo "完了: ${#SERVERS[@]} サーバー中 $FAILED 件失敗 / $WARN 件警告"
[ "$FAILED" -gt 0 ] && exit 1
exit 0

=== ディスク使用量チェック開始 (2026-08-10 11:24:36) ===
[OK]   srv01.example.local          56% /dev/sda1  50G  28G  22G
[OK]   srv02.example.local          63% /dev/sda1  50G  31G  19G
[FAIL] srv03.example.local          ssh: connect to host srv03.example.local: Connection timed out
[WARN] srv04.example.local          91% /dev/sda1  80G  73G   7G  <- 使用率 91%
[OK]   srv05.example.local          48% /dev/sda1  80G  38G  42G
===
完了: 5 サーバー中 1 件失敗 / 1 件警告

The authenticity of host 'srv01.example.local (192.168.1.101)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

# エラー出力例
srv02.example.local: Permission denied (publickey,gssapi-keyex,gssapi-with-mic).

# 公開鍵を配布する（初回のみパスワード入力が必要）
ssh-copy-id -i ~/.ssh/id_ed25519.pub ユーザー名@srv02.example.local

# ncコマンドでSSHポート（22番）の疎通確認（0: 成功 / 1: 失敗）
nc -zv -w 3 srv03.example.local 22