シェルスクリプトを実行場所に依存しない設計にする方法｜dirname・pushdとpopdで相対パスの罠を回避する実装パターン

この記事のポイント

・dirname $0 でスクリプト自身のディレクトリを絶対パスで取得できる
・pushd/popd で cd 前のディレクトリを保存・復元できる
・サブシェル ( ) でディレクトリ変更を外に影響させない設計がある
・trap EXIT と組み合わせて失敗時のクリーンアップを確実にできる

#!/bin/bash
# 設定ファイルを相対パスで読み込む（危険な例）
source ./config.sh
# ログも相対パスで指定（危険な例）
LOG=./logs/backup.log
echo "バックアップ開始" >> "$LOG"

#!/bin/bash
set -euo pipefail

# スクリプト自身のディレクトリを絶対パスで取得する
SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)

# 以降は SCRIPT_DIR を起点に絶対パスを組み立てる
source "${SCRIPT_DIR}/config.sh"
LOG="${SCRIPT_DIR}/logs/backup.log"

# SCRIPT_DIR の中身を確認する例
$ echo "$SCRIPT_DIR"
/home/user/scripts

# source で読み込まれるライブラリスクリプト（lib/utils.sh）の場合
LIB_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
CONFIG="${LIB_DIR}/../config/settings.conf"

#!/bin/bash
# シンボリックリンク越しに呼ばれても本体のディレクトリを取得する
REAL_PATH=$(readlink -f "$0")
SCRIPT_DIR=$(dirname "$REAL_PATH")

# 危険な例：cd に失敗すると cd - に到達しない
cd /data/backups
tar czf archive.tar.gz ./target/
cd -

# pushd/popd を使ったパターン
pushd /data/backups > /dev/null
tar czf archive.tar.gz ./target/
popd > /dev/null
# ここでは元のディレクトリに戻っている

# サブシェルで作業ディレクトリを隔離するパターン
(
  cd /data/backups || exit 1
  tar czf archive.tar.gz ./target/
)
# サブシェルの外では元のディレクトリのまま

#!/bin/bash
set -euo pipefail

# スクリプトのディレクトリを絶対パスで取得
SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)

# 設定をスクリプト起点の絶対パスで指定
CONFIG="${SCRIPT_DIR}/config/backup.conf"
BACKUP_DIR="${SCRIPT_DIR}/backups"
LOG_DIR="${SCRIPT_DIR}/logs"
LOG_FILE="${LOG_DIR}/backup_$(date +%Y%m%d).log"

# 設定ファイルを読み込む
# shellcheck source=/dev/null
source "$CONFIG"

# ログディレクトリが無ければ作成する
mkdir -p "$LOG_DIR" "$BACKUP_DIR"

echo "[$(date +%F\ %T)] バックアップ開始" >> "$LOG_FILE"

# バックアップ対象ディレクトリに移動して tar を実行
(
  cd "${SOURCE_DIR}" || exit 1
  tar czf "${BACKUP_DIR}/backup_$(date +%Y%m%d_%H%M%S).tar.gz" . \
    >> "$LOG_FILE" 2>&1
)

echo "[$(date +%F\ %T)] バックアップ完了" >> "$LOG_FILE"

#!/bin/bash
set -euo pipefail

SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
_PUSHED=0  # pushd 済みかどうかのフラグ

# スクリプト終了時に必ず元のディレクトリに戻る
cleanup() {
  if [[ "$_PUSHED" -eq 1 ]]; then
    popd > /dev/null 2>&1 || true
  fi
}
trap cleanup EXIT

# 作業ディレクトリに移動
WORK_DIR="${SCRIPT_DIR}/work"
mkdir -p "$WORK_DIR"
pushd "$WORK_DIR" > /dev/null
_PUSHED=1

# 作業処理
cp "${SCRIPT_DIR}/template.conf" ./current.conf

popd > /dev/null
_PUSHED=0

# ディレクトリが無ければ作成してから移動する
mkdir -p "${TARGET_DIR}"
pushd "${TARGET_DIR}" > /dev/null

# サブシェルの結果を外部に渡す例（標準出力を利用）
RESULT=$(
  cd /data || exit 1
  wc -l < target.txt
)
echo "行数: ${RESULT}"