シェルスクリプトのwhileループとポーリング設計｜サービス起動待ち・ファイル生成待ち・条件成立まで繰り返す実装パターン

この記事のポイント

・whileループとsleepを組み合わせたポーリングの基本構造
・サービス起動・ファイル生成・URL応答待ちの実践パターン
・タイムアウトと上限回数で無限ループを確実に防ぐ設計
・ログ出力と終了コードで呼び出し元に状態を伝える設計

#!/bin/bash

TIMEOUT=60        # タイムアウトまでの最大秒数
INTERVAL=5        # チェック間隔（秒）
elapsed=0

while true; do
    # 条件チェック（ここを用途に応じて書き換える）
    if <条件>; then
        echo "[OK] 条件成立（${elapsed}秒後）"
        exit 0
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] タイムアウト（${TIMEOUT}秒待機）" >&2
        exit 1
    fi

    echo "[WAIT] 条件未成立。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

#!/bin/bash
# サービス起動を最大60秒待機する

SERVICE="mysql"
TIMEOUT=60
INTERVAL=5
elapsed=0

echo "[INFO] ${SERVICE} の起動を待機します（タイムアウト: ${TIMEOUT}秒）"

while true; do
    if systemctl is-active --quiet "${SERVICE}"; then
        echo "[OK] ${SERVICE} が起動しました（${elapsed}秒後）"
        exit 0
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] ${SERVICE} がタイムアウト内に起動しませんでした" >&2
        exit 1
    fi

    echo "[WAIT] ${SERVICE} 未起動。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

# mysql起動後、ポーリングスクリプトを呼び出す
# root @ server01 ~
# systemctl start mysql && ./wait-service.sh
[INFO] mysql の起動を待機します（タイムアウト: 60秒）
[WAIT] mysql 未起動。5秒後に再確認（経過: 0秒）
[OK] mysql が起動しました（5秒後）

# タイムアウトした場合
# root @ server01 ~
# ./wait-service.sh
[INFO] mysql の起動を待機します（タイムアウト: 60秒）
[WAIT] mysql 未起動。5秒後に再確認（経過: 0秒）
[WAIT] mysql 未起動。5秒後に再確認（経過: 5秒）
[WAIT] mysql 未起動。5秒後に再確認（経過: 10秒）
...（省略）
[ERROR] mysql がタイムアウト内に起動しませんでした
# echo $?
1

#!/bin/bash
# ポート3306（MySQL）が応答するまで待機する

HOST="127.0.0.1"
PORT=3306
TIMEOUT=60
INTERVAL=3
elapsed=0

while true; do
    if nc -z -w2 "${HOST}" "${PORT}" 2>/dev/null; then
        echo "[OK] ${HOST}:${PORT} 接続確認（${elapsed}秒後）"
        exit 0
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] ${HOST}:${PORT} タイムアウト（${TIMEOUT}秒）" >&2
        exit 1
    fi

    echo "[WAIT] 未接続。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

# ncがない環境では /dev/tcp で代替できる
if (echo >/dev/tcp/127.0.0.1/3306) 2>/dev/null; then
    echo "ポート3306 応答あり"
fi

#!/bin/bash
# 指定ファイルが生成されるまで最大300秒待機する

TARGET_FILE="/var/tmp/export/daily_report.csv"
TIMEOUT=300
INTERVAL=10
elapsed=0

while true; do
    if [[ -f "${TARGET_FILE}" ]]; then
        echo "[OK] ファイル確認: ${TARGET_FILE}（${elapsed}秒後）"
        exit 0
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] ファイル未生成のままタイムアウト: ${TARGET_FILE}" >&2
        exit 1
    fi

    echo "[WAIT] ファイル未生成。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

#!/bin/bash
# ファイルサイズが安定するまで待つ（書き込み完了確認）

TARGET_FILE="/var/tmp/export/daily_report.csv"
TIMEOUT=300
INTERVAL=10
STABLE_WAIT=3    # サイズ確認の間隔（秒）
elapsed=0

while true; do
    if [[ -f "${TARGET_FILE}" ]]; then
        size1=$(stat -c%s "${TARGET_FILE}")
        sleep "${STABLE_WAIT}"
        size2=$(stat -c%s "${TARGET_FILE}")
        if [[ "${size1}" -gt 0 && "${size1}" -eq "${size2}" ]]; then
            echo "[OK] ファイル書き込み完了（サイズ: ${size2} bytes、${elapsed}秒後）"
            exit 0
        fi
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] タイムアウト（${TIMEOUT}秒）" >&2
        exit 1
    fi

    echo "[WAIT] ファイル書き込み中。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

#!/bin/bash
# URLが200を返すまで最大120秒待機する

TARGET_URL="http://127.0.0.1:8080/health"
TIMEOUT=120
INTERVAL=5
elapsed=0

while true; do
    HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 3 "${TARGET_URL}")
    if [[ "${HTTP_STATUS}" == "200" ]]; then
        echo "[OK] ${TARGET_URL} が応答（HTTP ${HTTP_STATUS}）（${elapsed}秒後）"
        exit 0
    fi

    if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
        echo "[ERROR] タイムアウト。最後のHTTPステータス: ${HTTP_STATUS}" >&2
        exit 1
    fi

    echo "[WAIT] HTTP ${HTTP_STATUS}。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
    sleep ${INTERVAL}
    elapsed=$((elapsed + INTERVAL))
done

# 200または301（リダイレクト）を成功とみなす場合
if [[ "${HTTP_STATUS}" == "200" || "${HTTP_STATUS}" == "301" ]]; then
    echo "[OK] 応答確認（HTTP ${HTTP_STATUS}）"
    exit 0
fi

# 2xx系すべてを成功とみなす場合
if [[ "${HTTP_STATUS}" =~ ^2 ]]; then
    echo "[OK] 応答確認（HTTP ${HTTP_STATUS}）"
    exit 0
fi

#!/bin/bash
# デプロイ前の複数条件チェックスクリプト
# 使い方: ./pre-deploy-check.sh

set -euo pipefail

TIMEOUT=120
INTERVAL=5

# ポーリング汎用関数
wait_until() {
    local label="$1"
    local cmd="$2"
    local elapsed=0

    echo "[CHECK] ${label} を確認中..."

    while true; do
        if eval "${cmd}" 2>/dev/null; then
            echo "[OK] ${label} 確認完了（${elapsed}秒後）"
            return 0
        fi

        if [[ ${elapsed} -ge ${TIMEOUT} ]]; then
            echo "[ERROR] ${label} タイムアウト（${TIMEOUT}秒）" >&2
            return 1
        fi

        echo "[WAIT] 未確認。${INTERVAL}秒後に再確認（経過: ${elapsed}秒）"
        sleep ${INTERVAL}
        elapsed=$((elapsed + INTERVAL))
    done
}

# 各条件のチェック実行
wait_until "MySQL（ポート3306）" "nc -z -w2 127.0.0.1 3306"
wait_until "Redis（ポート6379）" "nc -z -w2 127.0.0.1 6379"
wait_until "アプリのヘルスチェック"     "curl -sf --connect-timeout 3 http://127.0.0.1:8080/health"

echo ""
echo "=== 全チェック完了。デプロイを続行します ==="
exit 0

# root @ server01 ~
# ./pre-deploy-check.sh
[CHECK] MySQL（ポート3306） を確認中...
[OK] MySQL（ポート3306） 確認完了（0秒後）
[CHECK] Redis（ポート6379） を確認中...
[WAIT] 未確認。5秒後に再確認（経過: 0秒）
[OK] Redis（ポート6379） 確認完了（5秒後）
[CHECK] アプリのヘルスチェック を確認中...
[WAIT] 未確認。5秒後に再確認（経過: 0秒）
[WAIT] 未確認。5秒後に再確認（経過: 5秒）
[OK] アプリのヘルスチェック 確認完了（10秒後）

=== 全チェック完了。デプロイを続行します ===

# デバッグモードで実行確認（-x は各コマンドと変数展開結果を表示する）
# root @ server01 ~
# bash -x ./wait-service.sh
+ SERVICE=mysql
+ TIMEOUT=60
+ INTERVAL=5
+ elapsed=0
+ true
+ systemctl is-active --quiet mysql
+ [[ 0 -ge 60 ]]
+ echo '[WAIT] mysql 未起動。5秒後に再確認（経過: 0秒）'
[WAIT] mysql 未起動。5秒後に再確認（経過: 0秒）
+ sleep 5
+ elapsed=5
...

# 条件コマンドを単体で実行して終了コードを確認する
# root @ server01 ~
# systemctl is-active --quiet mysql; echo $?
0      # 0なら成功（サービス稼働中）

# ファイルパスのチェック
# root @ server01 ~
# [[ -f "/var/tmp/export/daily_report.csv" ]] && echo "exists" || echo "not found"
not found   # パスが違っていないか確認する

# ncコマンドが入っているかどうかも確認する
# root @ server01 ~
# which nc
/usr/bin/nc