シェルスクリプトのDRY RUN設計｜--dry-runフラグと実行関数で危険な操作を安全にテストする方法

この記事のポイント

・DRY_RUN変数とexecute()関数で危険なコマンドの実行を一元制御できる
・--dry-runフラグで「実行しない」モードに切り替え、何が起きるかを事前確認できる
・DRY RUN時は[DRY-RUN]プレフィックスをログに出力して実行内容を可視化する
・バックアップ・デプロイスクリプトへそのまま転用できる実践パターンを紹介

#!/bin/bash
set -euo pipefail

# DRY RUN フラグ（デフォルトは false）
DRY_RUN=false

# 実行ラッパー関数
# DRY_RUN=true の時はコマンドを実行せずログだけ出力する
execute() {
    if "${DRY_RUN}"; then
        echo "[DRY-RUN] $*"
    else
        "$@"
    fi
}

# 通常実行: 実際にファイルを削除する
execute rm -f /tmp/old_backup.tar.gz

# DRY_RUN=true の場合の出力例:
# [DRY-RUN] rm -f /tmp/old_backup.tar.gz

#!/bin/bash
set -euo pipefail

DRY_RUN=false

# 引数パース
for arg in "$@"; do
    case "${arg}" in
        --dry-run|-n)
            DRY_RUN=true
            ;;
        --help|-h)
            echo "Usage: $0 [--dry-run] [--help]"
            echo "  --dry-run, -n  : 実際の変更を行わず内容を確認する"
            exit 0
            ;;
        *)
            echo "[ERROR] 不明なオプション: ${arg}" >&2
            exit 1
            ;;
    esac
done

execute() {
    if "${DRY_RUN}"; then
        echo "[DRY-RUN] $*"
    else
        "$@"
    fi
}

# DRY RUN ログの確認例
./backup.sh --dry-run 2>&1 | grep "DRY-RUN"

# 出力例:
# [DRY-RUN] rsync -avz /data/www/ user@backup-server:/backup/www/
# [DRY-RUN] rm -f /backup/www/20260601.tar.gz
# [DRY-RUN] gzip -c /tmp/db_dump.sql > /backup/db/20260808.sql.gz

#!/bin/bash
set -euo pipefail

# ---- 設定 ----
SRC_DIR="/data/www"
DEST_USER="backup"
DEST_HOST="192.168.1.50"
DEST_DIR="/backup/www"
RETENTION_DAYS=30
LOG_FILE="/var/log/backup.log"

# ---- DRY RUN 制御 ----
DRY_RUN=false

for arg in "$@"; do
    case "${arg}" in
        --dry-run|-n) DRY_RUN=true ;;
        --help|-h)
            echo "Usage: $0 [--dry-run]"
            exit 0
            ;;
    esac
done

execute() {
    if "${DRY_RUN}"; then
        echo "[DRY-RUN] $*"
    else
        "$@"
    fi
}

log() {
    local level="$1"; shift
    local prefix=""
    "${DRY_RUN}" && prefix="[DRY-RUN] " || true
    echo "$(date '+%Y-%m-%d %H:%M:%S') [${level}] ${prefix}$*" | tee -a "${LOG_FILE}"
}

# ---- メイン処理 ----
log INFO "バックアップ開始: ${SRC_DIR} -> ${DEST_USER}@${DEST_HOST}:${DEST_DIR}"

# rsync 転送（DRY_RUN=true なら rsync にも --dry-run を追加）
RSYNC_OPTS="-avz --delete"
"${DRY_RUN}" && RSYNC_OPTS="${RSYNC_OPTS} --dry-run" || true

# shellcheck disable=SC2086
execute rsync ${RSYNC_OPTS} "${SRC_DIR}/" "${DEST_USER}@${DEST_HOST}:${DEST_DIR}/"

# 古いバックアップの削除（RETENTION_DAYS日以上前のtar.gz）
execute find "${DEST_DIR}" -name "*.tar.gz" -mtime "+${RETENTION_DAYS}" -delete

log INFO "バックアップ完了"

# ステップ1: DRY RUNで内容確認
./backup.sh --dry-run

# 出力例（実際の変更はなし）:
# 2026-08-08 12:00:00 [INFO] [DRY-RUN] バックアップ開始 ...
# [DRY-RUN] rsync -avz --delete --dry-run /data/www/ backup@192.168.1.50:/backup/www/
# (rsync の転送予定ファイル一覧がここに表示される)
# [DRY-RUN] find /backup/www -name "*.tar.gz" -mtime +30 -delete

# ステップ2: 内容に問題がなければ本番実行
./backup.sh

# DRY RUN でも実際に実行する（読み取り専用操作に使う）
safe_execute() {
    "$@"
}

# DRY RUN 時はスキップする（書き込み・削除等に使う）
execute() {
    if "${DRY_RUN}"; then
        echo "[DRY-RUN] $*"
    else
        "$@"
    fi
}

# 使い分け例:
safe_execute stat /data/www           # DRY RUN でも実行（確認のため）
execute     rm -rf /backup/old/       # DRY RUN 時はスキップ

TMP_DIR="$(mktemp -d)"
# trap は DRY RUN に関係なく常に実行（一時ファイルを必ず削除する）
trap 'rm -rf "${TMP_DIR}"' EXIT INT TERM

# DRY RUN でも一時ファイルは作成して内容を確認する
curl -sf "https://example.com/api/data" > "${TMP_DIR}/data.json"
safe_execute cat "${TMP_DIR}/data.json"  # 内容確認（DRY RUN でも表示）

# 本番への書き込みだけ DRY RUN でスキップ
execute cp "${TMP_DIR}/data.json" /etc/app/config.json

# execute() を通さない破壊的操作の呼び出しを検出する
grep -En "^[[:space:]]*(rm|cp|mv|rsync|find) " backup.sh | grep -v "execute"

# 出力があれば要修正（execute() でラッピングする）