#!/usr/bin/env bash

# ==============================================================================


# 堅牢なデータ同期スクリプト (APIデータ取得 & バリデーション & 配置)


# ==============================================================================

# -e: コマンドの終了ステータスが非ゼロの場合に即時終了


# -u: 未定義の変数を使用しようとした場合にエラーとして終了


# -o pipefail: パイプライン内のいずれかのコマンドが失敗した段階でパイプ全体を失敗とみなす

set -euo pipefail

# ロギング用関数

log() {
    echo "[$(date +'%Y-%m-%dT%H:%M:%S%z')] [$0] $1"
}

# ----------------------------------------------------------------              


# 環境変数・パス設定


# ----------------------------------------------------------------

API_URL="https://api.example.com/v1/metrics"
API_TOKEN_FILE="/etc/opt/myapp/api_token"
OUTPUT_DIR="/var/lib/myapp/data"
OUTPUT_FILE="${OUTPUT_DIR}/latest_metrics.json"
TMP_FILE=""

# ----------------------------------------------------------------


# トラップ (エラー処理 & クリーンアップ) の定義


# ----------------------------------------------------------------

cleanup() {

    # 直前のコマンドの終了ステータスを退避

    local exit_code=$?

    # 作成された一時ファイルがあれば確実に消去

    if [ -n "${TMP_FILE:-}" ] && [ -f "$TMP_FILE" ]; then
        log "INFO: 一時ファイルを安全に削除しています: ${TMP_FILE}"
        rm -f "$TMP_FILE"
    fi

    if [ "$exit_code" -ne 0 ]; then
        log "ERROR: 処理中にエラーが発生したため、異常終了しました (ステータス: ${exit_code})"
    else
        log "SUCCESS: すべての処理が正常に完了しました"
    fi
    exit "$exit_code"
}

# EXITシグナル（正常終了・シグナル・エラー停止問わず実行）でcleanupをコール

trap cleanup EXIT

# ----------------------------------------------------------------


# メイン処理開始


# ----------------------------------------------------------------

log "INFO: 処理を開始します"

# 必要な設定ファイルのチェック

if [ ! -f "$API_TOKEN_FILE" ]; then
    log "ERROR: APIトークンファイルが見つかりません: ${API_TOKEN_FILE}"
    exit 1
fi

# セキュアな一時ファイルの生成 (格納ディレクトリは /tmp)

TMP_FILE=$(mktemp /tmp/sync_metrics.XXXXXX)

# トークンの読み出し (不要な環境変数展開を避けるためファイルから直接取得)

API_TOKEN=$(cat "$API_TOKEN_FILE")

log "INFO: 外部APIからデータを取得中..."

# curlのオプション解説:


# -s: サイレントモード (進捗バー非表示)


# -S: エラー時のみエラーメッセージを表示


# -L: リダイレクトを追跡


# -f: HTTPレスポンスコードが400以上の場合にエラーとして処理を終了


# --retry: 一時エラー時の最大リトライ回数


# --retry-delay: リトライ間のウェイト(秒)


# --max-time: 最大許容タイムアウト時間(秒)

curl -s -S -L -f \
     --retry 3 \
     --retry-delay 2 \
     --max-time 15 \
     -H "Authorization: Bearer ${API_TOKEN}" \
     "${API_URL}" > "$TMP_FILE"

log "INFO: データの整合性を検証しています..."

# jqのオプション解説:


# -e: フィルタの出力が null または false の場合に終了ステータスを 1 にする


# .status: レスポンス内のステータスフラグ

if ! jq -e '.status == "success"' "$TMP_FILE" > /dev/null 2>&1; then
    log "ERROR: 取得データの検証に失敗しました。仕様に合致しないJSON、またはstatusがsuccessではありません。"
    exit 2
fi

# 必要箇所のフィルタリングとアトミック（不可分）なファイル移動

mkdir -p "$OUTPUT_DIR"

# 一時ファイルに中間出力を書き込んでから移動する (書込み中ファイルの読み出しを防ぐ)

jq '.data' "$TMP_FILE" > "${OUTPUT_FILE}.tmp"
mv "${OUTPUT_FILE}.tmp" "$OUTPUT_FILE"

log "INFO: データを正常に更新しました: ${OUTPUT_FILE}"

[Unit]
Description=My Application Data Synchronization Service
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
User=myapp
Group=myapp
ExecStart=/usr/local/bin/sync_metrics.sh

# セキュリティ向上のためのサンドボックス設定

PrivateTmp=true
ProtectSystem=full
ProtectHome=true
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

[Unit]
Description=Run My Application Data Synchronization Service hourly

[Timer]

# 毎時0分に起動

OnCalendar=hourly

# 前回システムダウン等でスキップされた場合は即座に実行

Persistent=true

[Install]
WantedBy=timers.target

# 権限の付与

sudo chmod +x /usr/local/bin/sync_metrics.sh

# 手動によるシステム実行

sudo systemctl start myapp-sync.service

# 実行成否と成果物の確認

ls -la /var/lib/myapp/data/latest_metrics.json

# 稼働ステータスと直近のログを表示

sudo systemctl status myapp-sync.service

# サービス詳細ログのリアルタイム監視

sudo journalctl -u myapp-sync.service -f