シェルスクリプトの起動前チェック設計｜依存コマンド・環境変数・ディレクトリを自動検証する実装パターン

この記事のポイント

・command -v でコマンドの存在を検証し、未インストールを即座に検知する
・必須環境変数は require_env 関数で存在チェックして早期終了する
・require_cmd / require_env / require_dir を preflight_check() にまとめる
・チェックが1つでも失敗したらメイン処理は実行しない設計が安全

#!/bin/bash
set -euo pipefail

# rsyncが存在しなければ即エラー終了
if ! command -v rsync > /dev/null 2>&1; then
  echo "[ERROR] rsync がインストールされていません。yum install rsync で導入してください。" >&2
  exit 1
fi

echo "[INFO] rsync: $(command -v rsync)"
# 出力例: [INFO] rsync: /usr/bin/rsync

#!/bin/bash
set -euo pipefail

# 未設定・空文字の場合はエラーメッセージを出して終了
: "${BACKUP_DIR:?BACKUP_DIR が未設定です。export BACKUP_DIR=/mnt/backup のように設定してください。}"
: "${REMOTE_USER:?REMOTE_USER が未設定です。}"
: "${TARGET_HOST:?TARGET_HOST が未設定です。}"

#!/bin/bash

BACKUP_DIR="${BACKUP_DIR:-/mnt/backup}"
LOG_DIR="/var/log/myapp"

# ディレクトリの存在確認
if [ ! -d "${LOG_DIR}" ]; then
  echo "[ERROR] ログディレクトリ ${LOG_DIR} が存在しません。" >&2
  exit 1
fi

# 書き込み権限の確認
if [ ! -w "${BACKUP_DIR}" ]; then
  echo "[ERROR] バックアップ先 ${BACKUP_DIR} に書き込み権限がありません。" >&2
  exit 1
fi

# コマンドの存在チェック関数
require_cmd() {
  local cmd="${1}"
  if ! command -v "${cmd}" > /dev/null 2>&1; then
    echo "[FATAL] コマンド '${cmd}' が見つかりません。インストールを確認してください。" >&2
    exit 1
  fi
  echo "[INFO] ${cmd}: $(command -v "${cmd}")"
}

# 環境変数の存在チェック関数
require_env() {
  local var_name="${1}"
  local val="${!var_name}"   # bash の間接参照で変数値を取得
  if [ -z "${val}" ]; then
    echo "[FATAL] 環境変数 '${var_name}' が未設定または空です。" >&2
    exit 1
  fi
}

# ディレクトリの存在・権限チェック関数
# 第2引数: "r"=読み込み確認(省略可)、"w"=書き込み確認
require_dir() {
  local dir="${1}"
  local mode="${2:-r}"
  if [ ! -d "${dir}" ]; then
    echo "[FATAL] ディレクトリ '${dir}' が存在しません。" >&2
    exit 1
  fi
  if [ "${mode}" = "w" ] && [ ! -w "${dir}" ]; then
    echo "[FATAL] ディレクトリ '${dir}' に書き込み権限がありません。" >&2
    exit 1
  fi
}

#!/bin/bash
set -euo pipefail

# ---- 設定値 ----
BACKUP_DIR="${BACKUP_DIR:-}"
REMOTE_USER="${REMOTE_USER:-}"
TARGET_HOST="${TARGET_HOST:-}"
LOG_DIR="/var/log/myapp"

# ---- 関数定義（require_cmd / require_env / require_dir は前節参照）----

preflight_check() {
  echo "[INFO] 起動前チェックを開始します..."
  require_cmd rsync
  require_cmd ssh
  require_env BACKUP_DIR
  require_env REMOTE_USER
  require_env TARGET_HOST
  require_dir "${LOG_DIR}" w
  require_dir "${BACKUP_DIR}" w
  echo "[INFO] 起動前チェック完了。メイン処理を開始します。"
}

main() {
  echo "[INFO] バックアップを開始します..."
  # ここに本体処理を書く
}

# ---- エントリーポイント ----
preflight_check
main

# ケース1: BACKUP_DIRを設定せずに実行した場合
$ ./backup.sh
[INFO] 起動前チェックを開始します...
[INFO] rsync: /usr/bin/rsync
[INFO] ssh: /usr/bin/ssh
[FATAL] 環境変数 'BACKUP_DIR' が未設定または空です。

# ケース2: バックアップ先ディレクトリへの権限がない場合
$ BACKUP_DIR=/mnt/backup REMOTE_USER=srvadmin TARGET_HOST=192.168.1.50 ./backup.sh
[INFO] 起動前チェックを開始します...
[INFO] rsync: /usr/bin/rsync
[INFO] ssh: /usr/bin/ssh
[FATAL] ディレクトリ '/mnt/backup' に書き込み権限がありません。

# ケース3: 全チェック通過・正常実行
$ export BACKUP_DIR=/mnt/backup REMOTE_USER=srvadmin TARGET_HOST=192.168.1.50
$ ./backup.sh
[INFO] 起動前チェックを開始します...
[INFO] rsync: /usr/bin/rsync
[INFO] ssh: /usr/bin/ssh
[INFO] 起動前チェック完了。メイン処理を開始します。
[INFO] バックアップを開始します...
[INFO] 転送完了: /mnt/backup/20260801-213045/

#!/bin/bash
# cronの環境でも確実にコマンドを探せるようにPATHを明示
PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
export PATH