シェルスクリプトでデプロイを自動化する方法｜ロールバック・排他制御・通知を組み込んだリリース設計

この記事のポイント

・flockコマンドで二重実行を防ぐ排他制御がデプロイスクリプトの基本
・rollback関数をtrap EXITに登録すると失敗時に旧バージョンへ自動切り戻せる
・ssコマンドでサービス起動を検証してからスクリプトを終了するのが安全設計
・通知はtrap EXITに集約し、成功・失敗どちらの経路でも確実に送出する

#!/bin/bash
# よくある「ただ並べただけ」のデプロイスクリプト（危険）
rsync -avz /build/webapp/ webadmin@192.168.1.10:/var/www/html/
ssh webadmin@192.168.1.10 "sudo systemctl restart httpd"
echo "デプロイ完了"

#!/bin/bash
# ロックファイルのパス
LOCKFILE="/var/run/deploy.lock"

# flockでロックを取得（取れなければ即終了）
exec 9>"${LOCKFILE}"
if ! flock -n 9; then
    echo "[ERROR] 別のデプロイが実行中です。終了します。" >&2
    exit 1
fi
echo "[INFO] ロック取得済み（PID: $$）"

#!/bin/bash
set -euo pipefail

DEPLOY_DIR="/var/www/html"
BACKUP_DIR="/var/backup/webapp"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_PATH="${BACKUP_DIR}/${TIMESTAMP}"

# ロールバック関数
rollback() {
    local exit_code=$?
    if [[ ${exit_code} -ne 0 ]]; then
        echo "[WARN] デプロイ失敗（終了コード: ${exit_code}）。ロールバックを開始します..." >&2
        # 直前のバックアップディレクトリを探して復元
        local latest_backup
        latest_backup=$(ls -dt "${BACKUP_DIR}"/*/ 2>/dev/null | head -1)
        if [[ -n "${latest_backup}" ]]; then
            rsync -a --delete "${latest_backup}/" "${DEPLOY_DIR}/"
            echo "[INFO] ロールバック完了: ${latest_backup}" >&2
        else
            echo "[ERROR] バックアップが見つかりません。手動で確認してください。" >&2
        fi
    fi
}

# EXIT シグナルでロールバック関数を呼ぶ
trap rollback EXIT

#!/bin/bash
NOTIFY_EMAIL="ops@example.com"
SCRIPT_START=$(date "+%Y-%m-%d %H:%M:%S")
DEPLOY_STATUS="SUCCESS"

notify() {
    local exit_code=$?
    if [[ ${exit_code} -ne 0 ]]; then
        DEPLOY_STATUS="FAILED (exit: ${exit_code})"
    fi
    local msg="[デプロイ通知] ${DEPLOY_STATUS} | 開始: ${SCRIPT_START} | 終了: $(date '+%Y-%m-%d %H:%M:%S')"
    # mailxが使える環境では以下で送信
    echo "${msg}" | mailx -s "[Deploy] ${DEPLOY_STATUS}" "${NOTIFY_EMAIL}" 2>/dev/null || \
        echo "[WARN] メール送信失敗（${msg}）" >&2
}

trap notify EXIT

#!/bin/bash
# ============================================================
# deploy.sh — Webアプリデプロイスクリプト（ロールバック対応版）
# 実行環境: RHEL 9.4 / Ubuntu 24.04 LTS
# ============================================================
set -euo pipefail

# ---- 設定 --------------------------------------------------
DEPLOY_DIR="/var/www/html/webapp"
BUILD_DIR="/opt/build/webapp"
BACKUP_DIR="/var/backup/webapp"
SERVICE_NAME="httpd"          # または nginx, tomcat など
SERVICE_PORT=80
NOTIFY_EMAIL="ops@example.com"
LOCKFILE="/var/run/deploy_webapp.lock"
LOG_FILE="/var/log/deploy_webapp.log"

# ---- ログ関数 -----------------------------------------------
TIMESTAMP() { date "+%Y-%m-%d %H:%M:%S"; }
log_info()  { echo "[$(TIMESTAMP)] INFO  $*" | tee -a "${LOG_FILE}"; }
log_warn()  { echo "[$(TIMESTAMP)] WARN  $*" | tee -a "${LOG_FILE}" >&2; }
log_error() { echo "[$(TIMESTAMP)] ERROR $*" | tee -a "${LOG_FILE}" >&2; }

SCRIPT_START=$(TIMESTAMP)
DEPLOY_STATUS="SUCCESS"

# ---- 排他制御 -----------------------------------------------
exec 9>"${LOCKFILE}"
if ! flock -n 9; then
    log_error "別のデプロイが実行中です（${LOCKFILE}）。終了します。"
    exit 1
fi
log_info "ロック取得済み（PID: $$）"

# ---- ロールバック関数 ----------------------------------------
rollback() {
    local exit_code=$?
    if [[ ${exit_code} -ne 0 ]]; then
        DEPLOY_STATUS="FAILED (exit: ${exit_code})"
        log_warn "デプロイ失敗。ロールバックを開始します..."
        local latest_backup
        latest_backup=$(ls -dt "${BACKUP_DIR}"/*/ 2>/dev/null | head -1)
        if [[ -n "${latest_backup}" ]]; then
            rsync -a --delete "${latest_backup}/" "${DEPLOY_DIR}/"
            sudo systemctl restart "${SERVICE_NAME}"
            log_info "ロールバック完了: ${latest_backup}"
        else
            log_error "バックアップが見つかりません。手動確認が必要です。"
        fi
    fi
}

# ---- 完了通知関数 --------------------------------------------
notify() {
    local msg="[Deploy ${DEPLOY_STATUS}] 開始: ${SCRIPT_START} / 終了: $(TIMESTAMP)"
    echo "${msg}" | mailx -s "[Deploy] ${DEPLOY_STATUS}" "${NOTIFY_EMAIL}" 2>/dev/null || \
        log_warn "メール送信失敗"
    log_info "${msg}"
}

# EXIT で必ずロールバック判定＋通知を実行
trap 'rollback; notify' EXIT

# ---- デプロイ本体 -------------------------------------------
main() {
    log_info "デプロイ開始（実行者: $(id -un), ビルド: ${BUILD_DIR}）"

    # 1. バックアップ
    local backup_path="${BACKUP_DIR}/$(date +%Y%m%d_%H%M%S)"
    mkdir -p "${backup_path}"
    rsync -a "${DEPLOY_DIR}/" "${backup_path}/"
    log_info "バックアップ完了: ${backup_path}"

    # 2. ファイル配布
    rsync -avz --delete "${BUILD_DIR}/" "${DEPLOY_DIR}/"
    log_info "ファイル配布完了"

    # 3. サービス再起動
    sudo systemctl restart "${SERVICE_NAME}"
    log_info "サービス再起動完了（${SERVICE_NAME}）"

    # 4. 起動確認（最大30秒待機）
    local retries=6
    while [[ ${retries} -gt 0 ]]; do
        if ss -tlnp | grep -q ":${SERVICE_PORT}"; then
            log_info "ポート ${SERVICE_PORT} 確認済み。デプロイ成功。"
            return 0
        fi
        log_info "ポート待機中... (残り ${retries} 回)"
        sleep 5
        (( retries-- ))
    done
    log_error "ポート ${SERVICE_PORT} が開かず。デプロイ失敗と判定します。"
    exit 1
}

main

# rsync実行例（webサーバー app01 への配布）
[2026-07-29 10:12:33] INFO  ファイル配布完了
sending incremental file list
./
index.html
assets/app.js
assets/app.css

sent 42,318 bytes  received 92 bytes  28,273.33 bytes/sec
total size is 158,244  speedup is 3.74

# ssコマンドでポート80の確認（デプロイ後の正常確認）
$ ss -tlnp | grep :80
LISTEN 0      128          0.0.0.0:80         0.0.0.0:*    users:(("httpd",pid=12345,fd=4))

# テスト用: 配布元ディレクトリを故意に空にして失敗を再現する
$ mkdir -p /opt/build/webapp_test
$ bash deploy.sh
[2026-07-29 10:15:00] INFO  ロック取得済み（PID: 23456）
[2026-07-29 10:15:00] INFO  デプロイ開始（実行者: webadmin, ビルド: /opt/build/webapp）
[2026-07-29 10:15:01] INFO  バックアップ完了: /var/backup/webapp/20260729_101500
[2026-07-29 10:15:05] ERROR ポート 80 が開かず。デプロイ失敗と判定します。
[2026-07-29 10:15:05] WARN  デプロイ失敗。ロールバックを開始します...
[2026-07-29 10:15:06] INFO  ロールバック完了: /var/backup/webapp/20260729_101455/
[Deploy FAILED (exit: 1)] 開始: 2026-07-29 10:15:00 / 終了: 2026-07-29 10:15:06

# ロックが残っているか確認する
$ flock -n /var/run/deploy_webapp.lock echo "ロック取得できる"
# 出力なし（取れない）→ まだロックされている

# ロックを保持しているプロセスを確認する
$ lsof /var/run/deploy_webapp.lock
COMMAND   PID      USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
bash    29081  webadmin    9uW  REG  253,1        0  ... /var/run/deploy_webapp.lock

# プロセスが存在しない（ゾンビ）場合のみロックファイルを削除する
$ kill -0 29081 2>/dev/null || rm -f /var/run/deploy_webapp.lock

# 1. サービスの状態を確認する
$ sudo systemctl status httpd
* httpd.service - The Apache HTTP Server
     Loaded: loaded (/usr/lib/systemd/system/httpd.service; enabled; vendor pr>
     Active: failed (Result: exit-code) since ...

# 2. ジャーナルログでエラー原因を確認する
$ sudo journalctl -u httpd --since "5 minutes ago"
Jul 29 10:15:07 web01.example.com httpd[23500]: httpd: Syntax error on line 92 of /etc/httpd/conf/httpd.conf

# 3. 設定ファイルの構文チェックを行う
$ sudo httpd -t
Syntax error on line 92 of /etc/httpd/conf/httpd.conf:
Invalid command 'DocumentRoot2', perhaps misspelled

# →  設定ファイルが壊れている。バックアップから設定ファイルも復元が必要
$ sudo rsync -a /var/backup/webapp/20260729_101455/conf/ /etc/httpd/conf/
$ sudo systemctl start httpd

#!/bin/bash
# cron から呼ばれる場合は PATH を先頭で明示する
PATH=/usr/local/bin:/usr/bin:/bin
export PATH