シェルスクリプトの事前チェック設計｜コマンド存在・実行権限・ディスク容量を冒頭でまとめて検証する方法

この記事のポイント

・command -v でコマンド存在を確認し、なければ即時エラー終了できる
・id コマンドと [ -w ] で root権限・書き込み権限をチェックできる
・df -k でディスク空き容量を数値比較し、不足時に処理を止められる
・全チェックを preflight 関数に集約すると本処理との責務が明確に分かれる

# コマンド存在確認の基本パターン
require_command() {
    local cmd="$1"
    if ! command -v "$cmd" > /dev/null 2>&1; then
        echo "[ERROR] 必要なコマンドが見つかりません: ${cmd}" >&2
        echo "[ERROR] インストールしてから再実行してください" >&2
        exit 1
    fi
}

# 使い方
require_command rsync
require_command mysqldump
require_command gzip

$ bash backup.sh
[ERROR] 必要なコマンドが見つかりません: mysqldump
[ERROR] インストールしてから再実行してください

# root権限チェック（id -u が 0 なら root）
require_root() {
    if [ "$(id -u)" -ne 0 ]; then
        echo "[ERROR] このスクリプトはroot権限で実行してください" >&2
        echo "[ERROR] sudo bash $(basename "$0") で再実行してください" >&2
        exit 1
    fi
}

# 書き込み権限チェック
require_writable() {
    local dir="$1"
    if [ ! -d "$dir" ]; then
        echo "[ERROR] ディレクトリが存在しません: ${dir}" >&2
        exit 1
    fi
    if [ ! -w "$dir" ]; then
        echo "[ERROR] ディレクトリへの書き込み権限がありません: ${dir}" >&2
        exit 1
    fi
}

# 使い方
require_root
require_writable /var/backup

[ec2-user@sv01 ~]$ bash deploy.sh
[ERROR] このスクリプトはroot権限で実行してください
[ERROR] sudo bash deploy.sh で再実行してください

# ディスク空き容量チェック（単位: MB）
require_disk_space() {
    local dir="$1"
    local required_mb="$2"
    # df -Pk: POSIXフォーマット・1024バイトブロック単位で出力
    local available_kb
    available_kb=$(df -Pk "$dir" | awk 'NR==2 {print $4}')
    local available_mb=$(( available_kb / 1024 ))
    if [ "$available_mb" -lt "$required_mb" ]; then
        echo "[ERROR] ディスク容量が不足しています: ${dir}" >&2
        echo "[ERROR] 必要: ${required_mb}MB / 利用可能: ${available_mb}MB" >&2
        exit 1
    fi
}

# 使い方（/var/backup に 2000MB 以上の空きが必要）
require_disk_space /var/backup 2000

[ERROR] ディスク容量が不足しています: /var/backup
[ERROR] 必要: 2000MB / 利用可能: 342MB

#!/bin/bash
# backup-db.sh — MySQLバックアップスクリプト
set -euo pipefail

BACKUP_DIR="/var/backup/mysql"
REQUIRE_MB=3000

# --- チェック関数 ---
require_command() {
    local cmd="$1"
    if ! command -v "$cmd" > /dev/null 2>&1; then
        echo "[ERROR] コマンドが見つかりません: ${cmd}" >&2
        exit 1
    fi
}

require_root() {
    if [ "$(id -u)" -ne 0 ]; then
        echo "[ERROR] root権限が必要です" >&2
        exit 1
    fi
}

require_writable() {
    local dir="$1"
    if [ ! -d "$dir" ] || [ ! -w "$dir" ]; then
        echo "[ERROR] 書き込み不可: ${dir}" >&2
        exit 1
    fi
}

require_disk_space() {
    local dir="$1" required_mb="$2"
    local avail_mb
    avail_mb=$(( $(df -Pk "$dir" | awk 'NR==2 {print $4}') / 1024 ))
    if [ "$avail_mb" -lt "$required_mb" ]; then
        echo "[ERROR] ディスク不足: 必要${required_mb}MB / 利用可能${avail_mb}MB" >&2
        exit 1
    fi
}

# --- preflight: ここで全条件を一括検証 ---
preflight() {
    echo "[INFO] 事前チェックを開始します..."
    require_root
    require_command mysqldump
    require_command gzip
    require_writable "$BACKUP_DIR"
    require_disk_space "$BACKUP_DIR" "$REQUIRE_MB"
    echo "[INFO] 事前チェック完了。本処理を開始します"
}

# --- 本処理 ---
main() {
    preflight
    local timestamp
    timestamp=$(date '+%Y%m%d_%H%M%S')
    local outfile="${BACKUP_DIR}/db_${timestamp}.sql.gz"
    mysqldump --all-databases | gzip > "$outfile"
    echo "[INFO] バックアップ完了: ${outfile}"
}

main "$@"

[root@sv01 ~]# bash backup-db.sh
[INFO] 事前チェックを開始します...
[INFO] 事前チェック完了。本処理を開始します
[INFO] バックアップ完了: /var/backup/mysql/db_20260924_034501.sql.gz

#!/bin/bash
set -euo pipefail

BACKUP_DIR="/var/backup/mysql"
TMPFILE=""

cleanup() {
    if [ -n "$TMPFILE" ] && [ -f "$TMPFILE" ]; then
        rm -f "$TMPFILE"
        echo "[INFO] 一時ファイルを削除しました: ${TMPFILE}" >&2
    fi
}

# EXIT シグナルで cleanup を必ず呼ぶ（正常終了・異常終了どちらでも）
trap cleanup EXIT

preflight() {
    require_root
    require_command mysqldump
    require_command gzip
    require_writable "$BACKUP_DIR"
    require_disk_space "$BACKUP_DIR" 3000
}

main() {
    preflight
    TMPFILE=$(mktemp /tmp/db_dump.XXXXXX)
    mysqldump --all-databases > "$TMPFILE"
    gzip -c "$TMPFILE" > "${BACKUP_DIR}/db_$(date '+%Y%m%d_%H%M%S').sql.gz"
    echo "[INFO] バックアップ完了"
}

main "$@"