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

この記事のポイント

・source コマンドで外部設定ファイルを読み込み、設定とロジックを分離できる
・APP_ENV 変数で development/production を判定し、設定ファイルを自動切り替えできる
・.env 形式に export を付けた設定管理が現場での実務標準
・必須変数チェックと :=（デフォルト値）で、想定外エラーを未然に防げる

# 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=production bash main.sh

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

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

# .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  ← シェルエラーになる

#!/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}"'

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