timeoutコマンドで制限時間付きでコマンドを実行する方法｜ハングアップ対策とシェルスクリプト活用も

この記事のポイント

・timeout コマンドで指定秒数を超えたプロセスを自動終了できる
・終了コード 124 で「タイムアウトによる終了」を判定できる
・--kill-after で SIGTERM の後に SIGKILL を送るダブル保険が設定できる
・パイプライン全体には bash -c でラップしてタイムアウトをかける

# タイムアウトなしのcronスクリプトが積み上がった例
# ps aux | grep backup.sh | grep -v grep
root      1482  0.0  0.0 14532  1908 ?   S    Jan10   0:00 bash /usr/local/bin/backup.sh
root      3241  0.0  0.0 14532  1912 ?   S    Jan10   0:00 bash /usr/local/bin/backup.sh
root      5109  0.0  0.0 14532  1904 ?   S    Jan10   0:00 bash /usr/local/bin/backup.sh
root      6873  0.0  0.0 14532  1908 ?   S    Jan11   0:00 bash /usr/local/bin/backup.sh
root      8244  0.0  0.0 14532  1916 ?   S    Jan11   0:00 bash /usr/local/bin/backup.sh
# ... 以下19プロセス続く

# 基本書式
timeout 秒数 コマンド [引数...]

# 例: 5秒以内に終わらなければ終了する
$ timeout 5 sleep 10
$ echo $?
124

# 30秒（単位なしの数値は秒）
timeout 30 コマンド

# 2分
timeout 2m コマンド

# 1時間
timeout 1h コマンド

# 90分（分単位で指定）
timeout 90m コマンド

# 1.5秒（小数指定も可）
timeout 1.5 コマンド

# SIGKILL（強制終了）を送信する
timeout -s SIGKILL 10 コマンド

# シグナル番号で指定（9=SIGKILL）
timeout -s 9 10 コマンド

# パイプライン全体に10秒のタイムアウト
timeout 10 bash -c 'cat /var/log/app.log | grep "ERROR" | wc -l'

# 複数コマンドのシーケンスに60秒のタイムアウト
timeout 60 bash -c '
    mysqldump -u root --single-transaction mydb > /tmp/dump.sql &&
    gzip /tmp/dump.sql
'

# 30秒でSIGTERM → さらに10秒待ってSIGKILL
timeout --kill-after=10 30 コマンド

# 短縮形
timeout -k 10 30 コマンド

timeout --kill-after=10 120 rsync -av /data/ user@backup-server:/backup/
exit_code=$?

case "${exit_code}" in
    0)   echo "バックアップ完了" ;;
    124) echo "WARN: タイムアウト（120秒）で終了しました" >&2 ;;
    137) echo "WARN: タイムアウト後にSIGKILLで強制終了しました" >&2 ;;
    *)   echo "ERROR: rsyncが失敗しました（exit: ${exit_code}）" >&2; exit 1 ;;
esac

#!/bin/bash
# 外部APIを30秒以内に呼び出す例

timeout 30 curl -s https://api.example.com/status -o /tmp/api_result.json
EXIT_CODE=$?

if [ $EXIT_CODE -eq 124 ]; then
    echo "ERROR: APIへの接続がタイムアウトしました" >&2
    exit 1
elif [ $EXIT_CODE -ne 0 ]; then
    echo "ERROR: curl が失敗しました（終了コード: ${EXIT_CODE}）" >&2
    exit 1
fi

echo "API応答を取得しました"
cat /tmp/api_result.json

#!/bin/bash
# タイムアウト付きコマンド実行関数
# 使い方: run_with_timeout 秒数 コマンド [引数...]
run_with_timeout() {
    local timeout_sec="$1"
    shift

    timeout --kill-after=10 "${timeout_sec}" "$@"
    local exit_code=$?

    if [ "${exit_code}" -eq 124 ] || [ "${exit_code}" -eq 137 ]; then
        echo "ERROR: タイムアウトしました（${timeout_sec}秒）: $*" >&2
        return 124
    fi
    return "${exit_code}"
}

# 使用例（各コマンドに個別のタイムアウトを指定できる）
run_with_timeout 10  curl -sf "https://api.example.com/health" || { echo "ヘルスチェック失敗"; exit 1; }
run_with_timeout 120 rsync -av /var/data/ user@backup-server:/backup/ || { echo "バックアップ失敗"; exit 1; }
run_with_timeout 30  mysqldump -u root mydb > /tmp/dump.sql || { echo "ダンプ失敗"; exit 1; }

# /etc/cron.d/backup-job の設定例
# バックアップスクリプトを最大115分でタイムアウトさせる
0 2 * * * root timeout -k 60 115m /usr/local/bin/backup.sh ＞＞ /var/log/backup.log 2>&1

#!/bin/bash
# スクリプト自身の実行時間を制限する
# 環境変数でガードして無限ループを防ぐ
if [ -z "${_TIMEOUT_GUARD:-}" ]; then
    export _TIMEOUT_GUARD=1
    exec timeout --kill-after=30 3600 "$0" "$@"
fi

# --- 以下、実際の処理 ---
set -euo pipefail
LOG_FILE="/var/log/backup.log"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] バックアップ開始" | tee -a "${LOG_FILE}"
rsync -av /var/data/ user@backup-server:/backup/ >> "${LOG_FILE}" 2>&1
echo "[$(date '+%Y-%m-%d %H:%M:%S')] バックアップ完了" | tee -a "${LOG_FILE}"

#!/bin/bash
TIMEOUT_SEC=60

# バックグラウンドで処理を起動してPIDを取得
long_process_command &
BG_PID=$!

# 最大TIMEOUT_SEC秒間、1秒ずつ生存確認する
elapsed=0
while kill -0 "${BG_PID}" 2>/dev/null; do
    if [ "${elapsed}" -ge "${TIMEOUT_SEC}" ]; then
        echo "WARN: タイムアウト（${TIMEOUT_SEC}秒）。プロセス ${BG_PID} を終了します" >&2
        kill -TERM "${BG_PID}" 2>/dev/null
        sleep 5
        kill -KILL "${BG_PID}" 2>/dev/null
        wait "${BG_PID}" 2>/dev/null
        exit 124
    fi
    sleep 1
    elapsed=$(( elapsed + 1 ))
done

# バックグラウンドプロセスの終了ステータスを取得
wait "${BG_PID}"
echo "処理完了（${elapsed}秒）"

# SSH接続のタイムアウトは -o ConnectTimeout が正しい
ssh -o ConnectTimeout=10 user@192.0.2.10 "コマンド"

# コマンド全体に上限をかけたい場合は timeout との組み合わせも有効
timeout 60 ssh -o ConnectTimeout=10 user@192.0.2.10 "バッチ処理.sh"

# setsid でプロセスグループをまとめて timeout にかける
timeout --kill-after=5 30 setsid コマンド

# プロセスが残っているか確認（ss / lsof でポートを確認するのも有効）
ss -tlnp | grep ポート番号

# コマンドが存在するか確認する
which コマンド名
type コマンド名

# 絶対パスで指定する
timeout 30 /usr/local/bin/myscript.sh

# インストール確認（RHEL/Rocky 系）
rpm -q coreutils

# インストール確認（Ubuntu/Debian 系）
dpkg -l coreutils

# バージョン確認
timeout --version

# 起動時にロックファイルのPIDが生きているか確認するパターン
LOCK_FILE="/var/run/backup.pid"

if [ -f "${LOCK_FILE}" ]; then
    OLD_PID=$(cat "${LOCK_FILE}")
    if kill -0 "${OLD_PID}" 2>/dev/null; then
        echo "ERROR: 前回の実行が残っています（PID: ${OLD_PID}）" >&2
        exit 1
    fi
    echo "WARN: 古いロックファイルを削除します（PID: ${OLD_PID}）" >&2
    rm -f "${LOCK_FILE}"
fi
echo $$ > "${LOCK_FILE}"
trap 'rm -f "${LOCK_FILE}"' EXIT SIGTERM