cronで動かすシェルスクリプトの設計パターン｜PATH・多重起動防止・ログ・エラー処理の4点セットを実装する方法

この記事のポイント

・cronの実行環境はPATH・LANG・HOMEがすべて異なる
・flockで多重起動防止を確実に実装できる
・set -euo pipefailでcronでもエラーを取りこぼさない
・4点セットを定型テンプレート化して全cron対象に適用する

# テスト用 crontab エントリ（crontab -e で追加する）
* * * * * env > /tmp/cron-env-test.txt 2>&1

[opr01@app-server01 ~]$ cat /tmp/cron-env-test.txt
HOME=/root
LOGNAME=root
PATH=/usr/bin:/bin
LANG=
SHELL=/bin/sh

#!/bin/bash
# PATH: cron環境でも外部コマンドを確実に見つけるために明示宣言
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
export PATH

# 日本語ログのためLANGを設定
LANG=ja_JP.UTF-8
export LANG

# スクリプト自身のディレクトリを変数化しておくと便利
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

# crontab -e の冒頭に記載する方法（ファイル全体に適用）
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
LANG=ja_JP.UTF-8

# ジョブ定義
0 2 * * * /opt/scripts/backup.sh

#!/bin/bash
# flock によるロックファイル取得（多重起動防止）
# -n: 非ブロッキングモード（既にロック取得済みなら即終了）
# -e 200: flock 失敗時の終了コード

LOCKFILE="/var/lock/myjob.lock"
exec 200>"${LOCKFILE}"
flock -n 200 || {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 前回実行中のためスキップ" >&2
    exit 0
}

# ここから本処理（多重起動されない）
echo "[$(date '+%Y-%m-%d %H:%M:%S')] 処理開始"
# ... 本処理 ...

[opr01@app-server01 ~]$ bash myjob.sh &
[1] 12483
[2026-10-03 14:22:01] 処理開始
[opr01@app-server01 ~]$ bash myjob.sh
[2026-10-03 14:22:02] 前回実行中のためスキップ

#!/bin/bash
# ... (PATH・flock設定の後)

# ログ設定
LOG_DIR="/var/log/myjobs"
LOG_FILE="${LOG_DIR}/myjob_$(date '+%Y%m%d').log"
mkdir -p "${LOG_DIR}"

# 以降の標準出力・標準エラーをタイムスタンプ付きでファイルに記録
# stdbuf -oL: バッファリングを無効化して即時ファイル書き込み
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
}
exec > >(tee -a "${LOG_FILE}") 2>&1

# 30日以上前のログを削除（crontab の別エントリでも可）
find "${LOG_DIR}" -name "myjob_*.log" -mtime +30 -delete

#!/bin/bash
set -euo pipefail
IFS=$'
	'

# ERR trap: エラー発生行をログに記録する
on_error() {
    local exit_code=$?
    log "ERROR: line ${BASH_LINENO[0]}: '${BASH_COMMAND}' が終了コード ${exit_code} で失敗"
    # 必要に応じてメール通知やSlack通知をここで呼ぶ
}
trap on_error ERR

# grepで一致なしは正常動作なので || true で許容
MATCHED=$(grep "ERROR" "${LOG_FILE}" || true)
if [[ -n "${MATCHED}" ]]; then
    log "エラー行を検出: ${MATCHED}"
fi

# 本処理を最大5分（300秒）で強制終了
timeout 300 /usr/bin/python3 /opt/scripts/process_api.py || {
    exit_code=$?
    if [[ ${exit_code} -eq 124 ]]; then
        log "ERROR: タイムアウト（300秒超過）で強制終了"
    else
        log "ERROR: 処理が終了コード ${exit_code} で失敗"
    fi
    exit 1
}

# crontab: cronが自動送信するメールを無効化
MAILTO=""

0 2 * * * /opt/scripts/backup.sh

# スクリプト内: エラー時だけメールを送る
on_error() {
    local exit_code=$?
    local msg="[ERROR] ${0}: line ${BASH_LINENO[0]} で失敗 (exit: ${exit_code})"
    log "${msg}"
    echo "${msg}" | mail -s "[CRON ALERT] $(hostname): ${0##*/}" admin@example.com
}
trap on_error ERR

#!/bin/bash
# ============================================================
# cronジョブ向けシェルスクリプト 標準テンプレート
# ============================================================
set -euo pipefail
IFS=$'
	'

# 1. 環境変数（cron環境で不足するものを明示宣言）
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
export PATH
LANG=ja_JP.UTF-8
export LANG

SCRIPT_NAME=$(basename "$0")
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

# 2. ログ設定
LOG_DIR="/var/log/myjobs"
LOG_FILE="${LOG_DIR}/${SCRIPT_NAME%.sh}_$(date '+%Y%m%d').log"
mkdir -p "${LOG_DIR}"
exec > >(tee -a "${LOG_FILE}") 2>&1

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
}

# 3. エラー処理
on_error() {
    local exit_code=$?
    log "ERROR: line ${BASH_LINENO[0]}: '${BASH_COMMAND}' が終了コード ${exit_code} で失敗"
}
trap on_error ERR

# 4. 多重起動防止
LOCKFILE="/var/lock/${SCRIPT_NAME%.sh}.lock"
exec 200>"${LOCKFILE}"
flock -n 200 || {
    log "前回実行中のためスキップ"
    exit 0
}

# --- ここから本処理 ---
log "処理開始"

# 例: 本処理を最大10分でタイムアウト
# timeout 600 /opt/scripts/actual_process.sh

log "処理完了"