シェルスクリプトの前提条件チェック設計｜実行前にコマンド・ファイル・権限・ディスク容量を一括検証する方法

この記事のポイント

・command -v でコマンドの存在を確認し、なければ即 exit する
・ファイル・ディレクトリ・権限は -f/-d/-r/-w テストで事前検証する
・ディスク空き容量は df -k と算術展開で数値化して閾値比較する
・require_cmd / require_dir 関数に集約するとどのスクリプトにも使い回せる

#!/bin/bash
set -euo pipefail

# コマンドが存在しなければエラーを出して終了する関数
require_cmd() {
    local cmd="$1"
    local hint="${2:-}"   # インストール方法のヒント（省略可）

    if ! command -v "${cmd}" &>/dev/null; then
        echo "[ERROR] 必要なコマンドが見つかりません: ${cmd}" >&2
        if [[ -n "${hint}" ]]; then
            echo "        インストール方法: ${hint}" >&2
        fi
        exit 1
    fi
}

# バックアップスクリプトの先頭で使う例
require_cmd rsync "yum install rsync または apt install rsync"
require_cmd tar
require_cmd gzip

check_required_cmds() {
    local cmds=("$@")
    local missing=0

    for cmd in "${cmds[@]}"; do
        if ! command -v "${cmd}" &>/dev/null; then
            echo "[ERROR] コマンドが見つかりません: ${cmd}" >&2
            missing=1
        fi
    done

    if [[ "${missing}" -eq 1 ]]; then
        echo "[ERROR] 必要なコマンドをインストールしてから再実行してください。" >&2
        exit 1
    fi
}

# 使い方
check_required_cmds rsync tar gzip openssl

require_file() {
    local path="$1"

    if [[ ! -f "${path}" ]]; then
        echo "[ERROR] ファイルが存在しません: ${path}" >&2
        exit 1
    fi

    if [[ ! -r "${path}" ]]; then
        echo "[ERROR] ファイルを読み取れません（権限不足）: ${path}" >&2
        exit 1
    fi
}

# 存在しなければ作成する設計
require_dir() {
    local path="$1"

    if [[ ! -d "${path}" ]]; then
        echo "[INFO] ディレクトリを作成します: ${path}"
        mkdir -p "${path}" || {
            echo "[ERROR] ディレクトリの作成に失敗しました: ${path}" >&2
            exit 1
        }
    fi

    if [[ ! -w "${path}" ]]; then
        echo "[ERROR] ディレクトリに書き込めません（権限不足）: ${path}" >&2
        exit 1
    fi
}

# 引数: パス, 最小必要容量(MB)
require_disk_space() {
    local path="$1"
    local min_mb="$2"

    # dfの出力から使用可能なブロック数(KB単位)を取得
    local avail_kb
    avail_kb=$(df -k "${path}" | awk 'NR==2 {print $4}')

    local avail_mb=$(( avail_kb / 1024 ))

    if [[ "${avail_mb}" -lt "${min_mb}" ]]; then
        echo "[ERROR] ディスク空き容量が不足しています。" >&2
        echo "        パス: ${path}" >&2
        echo "        必要: ${min_mb} MB / 現在の空き: ${avail_mb} MB" >&2
        exit 1
    fi

    echo "[INFO] ディスク空き容量: ${avail_mb} MB (必要: ${min_mb} MB) - OK"
}

$ require_disk_space /var/backup 500
[INFO] ディスク空き容量: 12480 MB (必要: 500 MB) - OK

# 環境変数が空でないことを確認する関数
require_env() {
    local varname="$1"
    local value="${!varname}"  # 変数名から値を間接参照

    if [[ -z "${value}" ]]; then
        echo "[ERROR] 環境変数 ${varname} が設定されていません。" >&2
        exit 1
    fi
}

# 使い方（設定ファイルをsourceした後）
source /etc/backup.conf
require_env BACKUP_SRC
require_env BACKUP_DEST
require_env BACKUP_GENERATIONS

#!/bin/bash
# backup.sh — 週次フルバックアップスクリプト
set -euo pipefail

# -------- 設定 --------
BACKUP_SRC="/var/www/html"
BACKUP_DEST="/mnt/backup"
BACKUP_GENERATIONS=7
MIN_DISK_MB=1024  # 最小空き容量(MB)

# -------- preflight チェック --------
preflight_check() {
    echo "=== preflight チェック開始 ==="

    # 1. 必要なコマンドの確認
    check_required_cmds tar gzip rsync

    # 2. バックアップ元の確認
    require_dir "${BACKUP_SRC}"

    # 3. バックアップ先の確認（なければ作成）
    require_dir "${BACKUP_DEST}"

    # 4. ディスク容量の確認
    require_disk_space "${BACKUP_DEST}" "${MIN_DISK_MB}"

    echo "=== preflight チェック完了 — 処理を開始します ==="
}

# -------- メイン処理 --------
main() {
    preflight_check

    local timestamp
    timestamp=$(date +%Y%m%d_%H%M%S)
    local archive="${BACKUP_DEST}/backup_${timestamp}.tar.gz"

    echo "[INFO] バックアップ開始: ${BACKUP_SRC} -> ${archive}"
    tar -czf "${archive}" -C "$(dirname "${BACKUP_SRC}")" "$(basename "${BACKUP_SRC}")"
    echo "[INFO] 完了: ${archive}"
}

main "$@"

$ bash backup.sh
=== preflight チェック開始 ===
[INFO] ディスク空き容量: 38400 MB (必要: 1024 MB) - OK
=== preflight チェック完了 — 処理を開始します ===
[INFO] バックアップ開始: /var/www/html -> /mnt/backup/backup_20260910_023001.tar.gz
[INFO] 完了: /mnt/backup/backup_20260910_023001.tar.gz