自作シェルスクリプトをsystemdサービス化して常駐運用する方法｜Unitファイル作成・Restart設定・ログ確認

この記事のポイント

・.serviceファイルはUnit/Service/Installの3セクションで構成する
・ExecStartには必ず絶対パスを指定する（相対パスはNG）
・Restart=on-failure + RestartSec=10 で自動復旧を設計できる
・journalctl -u サービス名 -f でリアルタイムログを確認できる

# Unitファイルを新規作成する
sudo vi /etc/systemd/system/myapp.service

[Unit]
Description=My Application Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/myapp.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

# systemdにUnitファイルの変更を通知する（必須）
sudo systemctl daemon-reload

# OS起動時の自動起動を有効化する
sudo systemctl enable myapp.service

# サービスをすぐに起動する
sudo systemctl start myapp.service

# 起動状態を確認する
sudo systemctl status myapp.service

# myapp.service - My Application Service
#    Loaded: loaded (/etc/systemd/system/myapp.service; enabled; vendor preset: disabled)
#    Active: active (running) since Sat 2026-07-19 10:00:00 JST; 3s ago
#  Main PID: 12345 (myapp.sh)
#    CGroup: /system.slice/myapp.service
#            `-12345 /bin/bash /usr/local/bin/myapp.sh

[Service]
Type=simple
# 起動前: 古いロックファイルを削除する（失敗しても続行する）
ExecStartPre=-/bin/rm -f /var/run/myapp.lock
# 本体スクリプト（絶対パスで指定する）
ExecStart=/usr/local/bin/myapp.sh
# 起動後: 起動完了をsyslogに記録する
ExecStartPost=/bin/logger "myapp.service started successfully"
Restart=on-failure
RestartSec=10

[Unit]
Description=My Application Service
After=network.target
# 60秒以内に5回失敗したら再起動を諦める
StartLimitIntervalSec=60
StartLimitBurst=5

[Service]
Type=simple
ExecStart=/usr/local/bin/myapp.sh
Restart=on-failure
# 再起動前に10秒待つ
RestartSec=10

# サービスの全ログを表示する
sudo journalctl -u myapp.service

# リアルタイムでログを追いかける（tail -f 相当）
sudo journalctl -u myapp.service -f

# 直近50行だけ表示する
sudo journalctl -u myapp.service -n 50

# 今日のログのみ表示する
sudo journalctl -u myapp.service --since today

# エラーレベル以上のみ表示する
sudo journalctl -u myapp.service -p err

# Jul 19 10:00:00 web01.example.com myapp.sh[12345]: [INFO] バックアップ処理を開始します
# Jul 19 10:00:05 web01.example.com myapp.sh[12345]: [INFO] /var/data のバックアップ完了
# Jul 19 10:00:05 web01.example.com myapp.sh[12345]: [INFO] 処理が完了しました
# Jul 19 10:00:05 web01.example.com systemd[1]: myapp.service: Deactivated successfully.

# エラー内容を確認する
sudo journalctl -u myapp.service -n 20
# ... Permission denied: '/usr/local/bin/myapp.sh' ...

# 実行権限を付与する
sudo chmod +x /usr/local/bin/myapp.sh

# サービスを再起動する
sudo systemctl restart myapp.service

# NG: 相対パス（サービスが起動しない）
ExecStart=./myapp.sh

# OK: 絶対パス（必ずこの形式にする）
ExecStart=/usr/local/bin/myapp.sh

# Unitファイル変更後に必ず実行する
sudo systemctl daemon-reload

# その後サービスを再起動する
sudo systemctl restart myapp.service

[Service]
# ファイルが存在しなくてもエラーにしない
EnvironmentFile=-/etc/myapp/env
ExecStart=/usr/local/bin/myapp.sh

#!/bin/bash
# /usr/local/bin/backup-watch.sh
# /var/data を定期的にバックアップする常駐スクリプト

BACKUP_SRC="/var/data"
BACKUP_DEST="/backup/data"
LOG_TAG="backup-watch"
INTERVAL=300  # 5分ごとに実行する

logger -t "$LOG_TAG" "サービス起動: 監視開始 ($BACKUP_SRC)"

while true; do
    if rsync -a --checksum "$BACKUP_SRC/" "$BACKUP_DEST/"; then
        logger -t "$LOG_TAG" "バックアップ完了"
    else
        logger -t "$LOG_TAG" "バックアップ失敗。サービスを終了します"
        exit 1
    fi
    sleep "$INTERVAL"
done

# 実行権限を付与する
sudo chmod +x /usr/local/bin/backup-watch.sh

# /etc/systemd/system/backup-watch.service
[Unit]
Description=Backup Watch Service
After=network.target
StartLimitIntervalSec=120
StartLimitBurst=5

[Service]
Type=simple
# 起動前にバックアップ先ディレクトリを作成する
ExecStartPre=/bin/mkdir -p /backup/data
ExecStart=/usr/local/bin/backup-watch.sh
Restart=on-failure
RestartSec=15
# 標準出力・エラーをjournaldに記録する
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable backup-watch.service
sudo systemctl start backup-watch.service
sudo systemctl status backup-watch.service

# backup-watch.service - Backup Watch Service
#    Loaded: loaded (/etc/systemd/system/backup-watch.service; enabled; vendor preset: disabled)
#    Active: active (running) since Sat 2026-07-19 10:05:00 JST; 10s ago
#  Main PID: 23456 (backup-watch.sh)
#    Tasks: 2 (limit: 4674)
#    Memory: 2.1M
#    CGroup: /system.slice/backup-watch.service
#            `-23456 /bin/bash /usr/local/bin/backup-watch.sh
#
# Jul 19 10:05:00 web01.example.com backup-watch[23456]: サービス起動: 監視開始 (/var/data)
# Jul 19 10:05:03 web01.example.com backup-watch[23456]: バックアップ完了