macOS Launchd에서 정기 실행 스크립트 이동

macOS Launchd를 사용하여 Cron처럼 정기적으로 실행되는 스크립트를 작성합니다. 환경 변수의 정비가 번거롭기 때문에, plist측의 설정은 최소로 하는 방식을 취한다.

구성은 다음과 같습니다.

plist → wrapper shell → main shell

래퍼 스크립트

환경 변수를 설정하고 실제 스크립트를 실행하여 로그로 리디렉션합니다.

#!/bin/bash

# XDG環境変数の設定
export XDG_STATE_HOME="${XDG_STATE_HOME:-$HOME/.local/state}"

# ログディレクトリの作成
LOG_DIR="$XDG_STATE_HOME/cron-like"
mkdir -p "$LOG_DIR"

# 実際のスクリプトを実行してログにリダイレクト
exec "$HOME/.local/bin/cron-like/every-minute.sh" \
    >> "$LOG_DIR/stdout.log" 2>> "$LOG_DIR/stderr.log"

plist 설정

매분 실행할 설정.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>localhost.cron.every-minute</string>
    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>/Users/username/.local/bin/cron-like/launchd.sh</string>
    </array>
    <key>StartInterval</key>
    <integer>60</integer>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

설정 스크립트

한 가지 설정을 자동화합니다.

#!/bin/bash

set -e

# ディレクトリの作成
mkdir -p "$HOME/.local/bin/cron-like"
mkdir -p "$HOME/.local/state/cron-like"
mkdir -p "$HOME/Library/LaunchAgents"

# ラッパースクリプトの作成
cat > "$HOME/.local/bin/cron-like/launchd.sh" <<'EOF'
#!/bin/bash

# XDG環境変数の設定
export XDG_STATE_HOME="${XDG_STATE_HOME:-$HOME/.local/state}"

# ログディレクトリの作成
LOG_DIR="$XDG_STATE_HOME/cron-like"
mkdir -p "$LOG_DIR"

# 実際のスクリプトを実行してログにリダイレクト
exec "$HOME/.local/bin/cron-like/every-minute.sh" \
    >> "$LOG_DIR/stdout.log" 2>> "$LOG_DIR/stderr.log"
EOF

# 実行スクリプトの作成
cat > "$HOME/.local/bin/cron-like/every-minute.sh" <<'EOF'
#!/bin/bash

# 実際の処理
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Running every-minute task"

# ここに実際の処理を記述
EOF

# 実行権限の付与
chmod +x "$HOME/.local/bin/cron-like/launchd.sh"
chmod +x "$HOME/.local/bin/cron-like/every-minute.sh"

# plistの作成
LABEL="localhost.cron.every-minute"
PLIST_PATH="$HOME/Library/LaunchAgents/${LABEL}.plist"

cat > "$PLIST_PATH" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>${LABEL}</string>
    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>$HOME/.local/bin/cron-like/launchd.sh</string>
    </array>
    <key>StartInterval</key>
    <integer>60</integer>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>
EOF

# 構文チェック
plutil -lint "$PLIST_PATH"

# 既にロードされている場合はアンロード
launchctl list | grep -q "$LABEL" && launchctl unload "$PLIST_PATH" 2>/dev/null || true

# ロード
launchctl load "$PLIST_PATH"

echo "✓ Setup complete!"
echo "  Scripts: $HOME/.local/bin/cron-like/"
echo "  Logs:    $HOME/.local/state/cron-like/"
echo "  plist:   $PLIST_PATH"
echo ""
echo "Commands:"
echo "  tail -f $HOME/.local/state/cron-like/stdout.log"
echo "  launchctl start $LABEL"
echo "  launchctl unload $PLIST_PATH"