シェルスクリプトの設定を外部ファイル化する設計｜sourceと.envで環境別に切り替える方法

この記事のポイント

・source コマンドで外部設定ファイルを読み込み、設定とロジックを分離できる
・「デフォルト値 → config.sh → 環境変数」の3層設計で dev・stg・prod を安全に切り替えられる
・読み込み前の存在確認・権限確認・必須値バリデーションがフェイルセーフ設計の要点
・source はサブシェルを作らないため変数が呼び出し元に引き継がれる（bash 直接実行との違い）

# config.sh — 設定ファイル
DB_HOST="192.168.1.100"
DB_NAME="myapp_db"
DB_USER="dbuser"
DB_PASS="P@ssw0rd"
APP_LOG_DIR="/var/log/myapp"

#!/bin/bash
# main.sh — メインスクリプト

# 設定ファイルの読み込み
source /etc/myapp/config.sh
# または . /etc/myapp/config.sh でも同じ

echo "DB接続先: ${DB_HOST}"
echo "ログ出力先: ${APP_LOG_DIR}"

#!/bin/bash
# スクリプト自身のディレクトリを取得
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# スクリプトと同じディレクトリにある設定ファイルを読み込む
source "${SCRIPT_DIR}/config.sh"

#!/bin/bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# APP_ENV が未設定の場合は development を使う
APP_ENV="${APP_ENV:-development}"

CONFIG_FILE="${SCRIPT_DIR}/config/${APP_ENV}.sh"

# 設定ファイルの存在確認
if [ ! -f "${CONFIG_FILE}" ]; then
    echo "[ERROR] 設定ファイルが見つかりません: ${CONFIG_FILE}" >&2
    exit 1
fi

source "${CONFIG_FILE}"
echo "環境: ${APP_ENV} / DB接続先: ${DB_HOST}"

# 開発環境で実行（デフォルト）
bash main.sh

# 検証環境で実行
APP_ENV=staging bash main.sh

# 本番環境で実行
APP_ENV=production bash main.sh

# または環境変数をexportしてから実行
export APP_ENV=production
bash main.sh

# crontab -e の記述例
APP_ENV=production
0 2 * * * /opt/myapp/bin/main.sh >> /var/log/myapp/cron.log 2>&1

myapp/
├── main.sh
└── config/
    ├── development.sh    # 開発環境用
    ├── staging.sh        # 検証環境用
    └── production.sh     # 本番環境用（.gitignoreで除外）

#!/bin/bash
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# 第1層: デフォルト値（config.shがなくても動作する最低限の設定）
BACKUP_SRC="${BACKUP_SRC:-/var/www/html}"
BACKUP_DEST="${BACKUP_DEST:-/tmp/backup_test}"
BACKUP_KEEP_DAYS="${BACKUP_KEEP_DAYS:-3}"
LOG_FILE="${LOG_FILE:-/tmp/backup.log}"

# 第2層: config.shで上書き（存在する場合のみ読み込む）
CONFIG_FILE="${SCRIPT_DIR}/config.sh"
if [ -f "${CONFIG_FILE}" ]; then
    source "${CONFIG_FILE}"
fi

# 第3層: 環境変数による最終上書き（CI/CDや緊急対応での優先設定）
BACKUP_DEST="${OVERRIDE_BACKUP_DEST:-${BACKUP_DEST}}"

echo "設定確認: BACKUP_SRC=${BACKUP_SRC}, BACKUP_DEST=${BACKUP_DEST}"

# .env.production（本番環境用設定）
export DB_HOST="db.example.com"
export DB_NAME="myapp_production"
export DB_USER="app_user"
export DB_PASS="P@ssw0rd_prod"
export APP_LOG_DIR="/var/log/myapp"
export MAIL_FROM="noreply@example.com"

# OK: ダブルクォートでスペースを含む値を保護
export APP_NAME="My Application"
export MAIL_SUBJECT="Backup completed"

# NG: スペースがあると想定外の解釈になる
# export APP_NAME=My Application  ← シェルエラーになる

# 設定ファイルを安全に読み込む関数
load_config() {
    local config_file="$1"

    # 1. ファイルの存在確認
    if [ ! -f "${config_file}" ]; then
        echo "[ERROR] 設定ファイルが見つかりません: ${config_file}" >&2
        return 1
    fi

    # 2. 権限確認（他ユーザーが書き込み可能な場合に警告）
    local perms
    perms=$(stat -c '%a' "${config_file}")
    if [ "${perms: -1}" -ge 2 ]; then
        echo "[WARNING] 他ユーザーが書き込める設定ファイルです（${perms}）: ${config_file}" >&2
    fi

    # 3. 所有者確認
    local owner
    owner=$(stat -c '%U' "${config_file}")
    if [ "${owner}" != "$(id -un)" ] && [ "${owner}" != "root" ]; then
        echo "[WARNING] 所有者が不審です（owner=${owner}）: ${config_file}" >&2
    fi

    source "${config_file}"
    echo "[INFO] 設定ファイルを読み込みました: ${config_file}"
}

# 推奨パーミッション設定
chmod 600 config/production.sh

# load_config 関数を使った安全な読み込み
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
load_config "${SCRIPT_DIR}/config/${APP_ENV:-development}.sh" || exit 1

#!/bin/bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
APP_ENV="${APP_ENV:-development}"
source "${SCRIPT_DIR}/config/${APP_ENV}.sh"

# 必須変数チェック関数
check_required_vars() {
    local missing=0
    for var in DB_HOST DB_NAME DB_USER DB_PASS; do
        if [ -z "${!var}" ]; then
            echo "[ERROR] 必須変数 ${var} が設定されていません" >&2
            missing=1
        fi
    done
    if [ "${missing}" -eq 1 ]; then
        exit 1
    fi
}

check_required_vars
echo "バリデーション OK — 処理を開始します"

# 変数が未設定または空の場合にデフォルト値を返す（変数は変更しない）
LOG_LEVEL="${LOG_LEVEL:-INFO}"

# 変数が未設定または空の場合にデフォルト値を設定する（変数も更新する）
: "${RETRY_COUNT:=3}"
: "${TIMEOUT_SEC:=30}"

echo "ログレベル: ${LOG_LEVEL}"
echo "リトライ回数: ${RETRY_COUNT}"
echo "タイムアウト: ${TIMEOUT_SEC}秒"

#!/bin/bash
set -euo pipefail
# -e: エラー発生時に即終了
# -u: 未定義変数を参照したらエラー
# -o pipefail: パイプライン途中のエラーも捕捉

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${SCRIPT_DIR}/config/${APP_ENV:-development}.sh"

# NG: カレントディレクトリから探すため、cronなどで失敗する
source config.sh

# OK: BASH_SOURCE[0]でスクリプト自身の場所を基準にする
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${SCRIPT_DIR}/config.sh"

# 実際に変数が読み込まれているか確認する手順
source "${SCRIPT_DIR}/config/${APP_ENV}.sh"

# 現在のシェルで定義されているか確認
echo "DB_HOST=${DB_HOST}"

# 子プロセスに渡っているか確認（exportがなければ空になる）
bash -c 'echo "子プロセス DB_HOST=${DB_HOST}"'

# NG: パイプの右辺はサブシェルで動くため変数が親プロセスに返らない
cat config.sh | while read line; do eval "$line"; done

# OK: sourceをそのまま直呼びする
source config.sh

# config.sh 内の書き方
# NG: 現在のシェルが終了してしまう
if [ -z "${DB_NAME}" ]; then exit 1; fi

# OK: 呼び出し元に失敗を返す（シェルは終了しない）
if [ -z "${DB_NAME}" ]; then
    echo "[ERROR] DB_NAME が未設定です" >&2
    return 1
fi

myapp/
├── bin/
│   └── main.sh              # メインスクリプト
├── config/
│   ├── common.sh            # 全環境共通設定
│   ├── development.sh       # 開発環境固有設定
│   ├── staging.sh           # 検証環境固有設定
│   └── production.sh        # 本番環境固有設定（gitignore対象）
├── lib/
│   └── functions.sh         # 共通関数定義
└── .gitignore

#!/bin/bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
CONFIG_DIR="${SCRIPT_DIR}/../config"
APP_ENV="${APP_ENV:-development}"

# 共通設定を先に読む
source "${CONFIG_DIR}/common.sh"

# 環境固有設定で上書き（共通設定より後に読む点が重要）
source "${CONFIG_DIR}/${APP_ENV}.sh"

# .gitignore
config/production.sh
config/staging.sh
.env
.env.*
!.env.example

＜PR＞手元に置いて学びを深める1冊

[改訂第3版]シェルスクリプト基本リファレンス ──#!/bin/shで、ここまでできる

source や .env を使った設定管理を含む、現場で使えるシェルスクリプト設計を体系的に押さえたい方に手元に置いてほしい一冊。まず無料メルマガで基礎を固め、さらに深めるなら本書。