bashのexecとファイルディスクリプタ操作｜スクリプト全体のログをリダイレクトする設計

この記事のポイント

・exec 1>>logfile 2>&1 でスクリプト全体の出力を一括ログ保存できる
・exec はbashの組み込みコマンドであり、docker exec とは別ツール
・exec 3>&1 でFDを複製しておけば、途中でstdoutを元に戻せる
・trap EXIT と組み合わせてFDを確実に閉じる設計が現場の定石

# 現在のシェルのFD接続先を確認する
ls -la /proc/$$/fd/

# 出力例（RHEL 9 / bash 5.1 環境）
# lrwx------. 1 user user 64 Jul 22 10:15 0 -> /dev/pts/0
# lrwx------. 1 user user 64 Jul 22 10:15 1 -> /dev/pts/0
# lrwx------. 1 user user 64 Jul 22 10:15 2 -> /dev/pts/0
# FD 0, 1, 2 すべてが端末（/dev/pts/0）に向いている

注意：docker exec とは別ツールです

Dockerを使っている方は「exec」という文字列に反応してしまうかもしれませんが、docker exec（実行中のコンテナ内でコマンドを実行する機能）とbash組み込みの exec は完全に別物です。本記事のexecはあくまでbashシェルの組み込み機能であり、Dockerとは無関係です。

#!/bin/bash
# スクリプト全体のstdoutを切り替える
exec 1>/tmp/test-exec.log

echo "ここからの出力はすべてlogfileに書かれる"
echo "端末には何も表示されない"
date
hostname

# /tmp/test-exec.log の内容（RHEL 9 実行例）
ここからの出力はすべてlogfileに書かれる
端末には何も表示されない
2026年 7月 22日 水曜日 10:30:00 JST
web01.example.local

#!/bin/bash
# stdout と stderr を同じlogfileに追記する
exec 1>>/var/log/myscript.log 2>&1

echo "[INFO] スクリプト開始"
ls /nonexistent_dir   # stderr が出るコマンド
echo "[INFO] スクリプト終了"

# /var/log/myscript.log（RHEL 9 実行例）
[INFO] スクリプト開始
ls: '/nonexistent_dir' にアクセスできません: そのようなファイルやディレクトリはありません
[INFO] スクリプト終了

#!/bin/bash
# 元の stdout（端末）をFD3に保存
exec 3>&1

# stdout をログファイルに切り替え
exec 1>/var/log/batch.log 2>&1

echo "[LOG] これはログに書かれる"

# FD3（元の端末）に直接書く
echo "[CONSOLE] これは端末にも表示される" >&3

echo "[LOG] 後続処理もログに書かれる"

# 後始末：FD3を閉じる
exec 3>&-

# FD1（stdout）を閉じる
exec 1>&-

# FD2（stderr）を閉じる
exec 2>&-

# FD3（ユーザー定義）を閉じる
exec 3>&-

#!/bin/bash
# cronジョブのログ集約テンプレート
# /usr/local/bin/daily-batch.sh

SCRIPT_NAME="$(basename "$0")"
LOG_DIR="/var/log/batch"
LOG_FILE="${LOG_DIR}/${SCRIPT_NAME%.sh}_$(date +%Y%m%d).log"

# ログディレクトリがなければ作成（exec より前に必ず実行）
mkdir -p "$LOG_DIR"

# スクリプト全体のstdout/stderrをログに向ける（追記モード）
exec 1>>"$LOG_FILE" 2>&1

echo "=========================================="
echo "[$(date '+%Y-%m-%d %H:%M:%S')] START: $SCRIPT_NAME"
echo "=========================================="

# --- ここから本処理 ---
echo "[INFO] データ処理を開始します"
# ... 実際の処理 ...
echo "[INFO] データ処理が完了しました"
# --- 本処理ここまで ---

echo "[$(date '+%Y-%m-%d %H:%M:%S')] END: $SCRIPT_NAME"

# crontab -e の設定例
# 毎日午前3時に実行（cron自体のメール通知は MAILTO= で無効化）
MAILTO=""
0 3 * * * /usr/local/bin/daily-batch.sh

#!/bin/bash
LOG_DIR="/var/log/batch"
RUN_ID="$(date +%Y%m%d_%H%M%S)"

mkdir -p "$LOG_DIR"

# stdout と stderr を別ファイルに振り分ける
exec 1>>"${LOG_DIR}/out_${RUN_ID}.log"
exec 2>>"${LOG_DIR}/err_${RUN_ID}.log"

echo "[INFO] バッチ処理を開始"
ls /nonexistent_dir    # stderrに記録される
echo "[INFO] バッチ処理を終了"

# 確認方法:
# tail /var/log/batch/out_20260722_030000.log   # 正常出力
# tail /var/log/batch/err_20260722_030000.log   # エラーのみ

#!/bin/bash

# パターン1: stdout のみ捨てる（stderr はそのまま → cron がメール通知）
exec 1>/dev/null

# パターン2: stdout も stderr も捨てる（完全サイレント）
exec 1>/dev/null 2>&1

echo "この出力は /dev/null に捨てられる"
ls /nonexistent   # パターン1では stderr → cron 経由でメール通知される

#!/bin/bash
LOG_FILE="/var/log/batch/$(date +%Y%m%d).log"
mkdir -p "$(dirname "$LOG_FILE")"

# stdout/stderr をログに向ける
exec 1>>"$LOG_FILE" 2>&1

# EXIT シグナルで終了ログを記録してFDを閉じる
cleanup() {
    local exit_code=$?
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] Script ended (exit code: ${exit_code})"
    exec 1>&- 2>&-
}
trap cleanup EXIT

echo "[$(date '+%Y-%m-%d %H:%M:%S')] Script started"

# --- 本処理 ---
echo "[INFO] 処理を実行中"

# エラーが起きても trap EXIT が必ず呼ばれる
# set -e を使う場合、コマンドが失敗してもcleanupは実行される

#!/bin/bash
LOG_FILE="/tmp/function_log.log"

# 元の stdout（端末）をFD3に保存
exec 3>&1

log_section() {
    # 関数内だけログファイルに切り替え
    exec 1>>"$LOG_FILE" 2>&1
    echo "[LOG] 関数内の処理"
    hostname
    date
    # FD3（元の端末）に戻す
    exec 1>&3
}

echo "この出力は端末に表示される（FD1=端末）"
log_section
echo "ここも端末に表示される（FD1が端末に復元済み）"

# 後始末：FD3を閉じる
exec 3>&-

# NG: ディレクトリがなければ exec が失敗して以降の出力が消える
exec 1>>/var/log/newdir/batch.log 2>&1

# OK: execより前に必ずディレクトリを作成する
mkdir -p /var/log/newdir
exec 1>>/var/log/newdir/batch.log 2>&1