#!/bin/bash


# スクリプト名: robust_script.sh

# --- 1. 基本設定とエラーハンドリング ---

set -euo pipefail
set -E # trapがサブシェルでも機能するように

# 一時ディレクトリの作成 (mktemp -dで安全に作成)


# Big-O: O(1) for directory creation.


# Memory: Negligible.

TMP_DIR=$(mktemp -d -t myapp-XXXXXXXXXX)
readonly TMP_DIR

# エラー発生時のクリーンアップと終了処理


# trap ERRはset -eで終了する前に実行される

trap cleanup ERR

# 正常終了時のクリーンアップ

trap cleanup EXIT

cleanup() {
    local exit_code="$?" # trap内で直前のコマンドの終了コードを取得
    if [ -d "${TMP_DIR}" ]; then
        echo "$(date '+%Y-%m-%d %H:%M:%S JST') [INFO] 一時ディレクトリ ${TMP_DIR} を削除します。"

        # Recursively remove the temporary directory


        # Big-O: O(N) where N is number of files/dirs in TMP_DIR.


        # Memory: Depends on system buffer for file operations.

        rm -rf "${TMP_DIR}"
    fi

    if [ "${exit_code}" -ne 0 ]; then
        echo "$(date '+%Y-%m-%d %H:%M:%S JST') [ERROR] スクリプトがエラーコード ${exit_code} で終了しました。" >&2

        # エラーログの具体的な場所を指示

        echo "$(date '+%Y-%m-%d %H:%M:%S JST') [ERROR] 詳細はシステムのログ (例: journalctl -u myapp.service) を確認してください。" >&2
    else
        echo "$(date '+%Y-%m-%d %H:%M:%S JST') [INFO] スクリプトは正常に完了しました。"
    fi
    exit "${exit_code}"
}

log_info() {
    echo "$(date '+%Y-%m-%d %H:%M:%S JST') [INFO] $1"
}

log_error() {
    echo "$(date '+%Y-%m-%d %H:%M:%S JST') [ERROR] $1" >&2
}

# --- 2. root権限の扱いと権限分離 ---


# スクリプトは最小限の権限で実行することが基本。


# 特定の操作でroot権限が必要な場合は、sudoを明示的に利用する。


# ただし、sudoersの設定は慎重に行い、特定のコマンドのみ許可するようにする。

check_root_permission() {
    if [ "$(id -u)" -eq 0 ]; then
        log_error "本スクリプトはroot権限で実行しないでください。必要な操作はsudoを用いてください。"
        return 1 # エラーとして終了
    fi
    return 0
}

# --- 3. curl を用いた安全な外部通信 ---

fetch_data_from_api() {
    local url="$1"
    local output_file="$2"
    local max_retries=5
    local retry_delay_sec=5 # 初期遅延秒数

    log_info "APIからデータを取得中: ${url}"

    # curlのオプション:


    # --fail-with-body: HTTPエラー時にレスポンスボディを標準エラーに出力し、非ゼロ終了


    # --retry <num>: 失敗時に再試行する回数


    # --retry-delay <seconds>: 初回の再試行までの遅延時間（秒）


    # --retry-max-time <seconds>: 再試行を含めた最大実行時間


    # --tlsv1.2: TLSv1.2の使用を強制 (推奨)


    # --cacert <file>: CA証明書を指定してサーバ証明書を検証 (必要に応じて)


    # --compressed: 可能な場合、圧縮されたレスポンスを要求


    # -o: 出力ファイルを指定


    # -s: サイレントモード (プログレスメータ非表示)


    # -S: エラー表示を有効にする (サイレントモードと併用)


    # Big-O: O(1) per request, but total time depends on retries and delay.


    # Memory: Depends on response size.

    if ! curl --fail-with-body \
              --retry "${max_retries}" \
              --retry-delay "${retry_delay_sec}" \
              --retry-max-time 60 \
              --tlsv1.2 \
              --compressed \
              -sS \
              -o "${output_file}" \
              "${url}"; then
        log_error "APIからのデータ取得に失敗しました: ${url}"
        return 1
    fi
    log_info "データを ${output_file} に保存しました。"
    return 0
}

# --- 4. jq を用いたJSONデータの堅牢な処理 ---

process_json_data() {
    local input_file="$1"
    local output_key="$2"
    local output_value

    log_info "${input_file} からJSONデータを処理中..."

    # jq -e: フィルタが値を出力しなかった場合、または出力がfalse/nullだった場合、非ゼロ終了


    # Big-O: O(N) where N is the size of the JSON input.


    # Memory: Proportional to JSON input size.

    if ! output_value=$(jq -r ".${output_key}" "${input_file}"); then
        log_error "JSONファイル ${input_file} のキー .${output_key} の処理に失敗しました。無効なJSONまたはキーが存在しない可能性があります。"
        return 1
    fi

    if [ -z "${output_value}" ]; then
        log_error "JSONファイル ${input_file} のキー .${output_key} から値が取得できませんでした (空またはnull)。"
        return 1
    fi

    log_info "抽出された値 for ${output_key}: ${output_value}"
    echo "${output_value}" # 結果を標準出力に返す
    return 0
}

# --- 5. メイン処理 ---

main() {
    log_info "スクリプト実行開始 (PID: $$)"

    if ! check_root_permission; then
        exit 1
    fi

    local api_url="https://jsonplaceholder.typicode.com/posts/1" # テスト用API
    local json_file="${TMP_DIR}/response.json"
    local target_key="title"

    if ! fetch_data_from_api "${api_url}" "${json_file}"; then
        log_error "データ取得ステップで失敗しました。"
        exit 1
    fi

    local extracted_title
    if ! extracted_title=$(process_json_data "${json_file}" "${target_key}"); then
        log_error "JSON処理ステップで失敗しました。"
        exit 1
    fi

    log_info "最終的に取得されたタイトル: ${extracted_title}"
    log_info "スクリプトは正常終了に向かいます。"
}

# スクリプト実行

main "$@"

[Unit]
Description=My Application Data Fetching Script
Documentation=https://example.com/docs/myapp
After=network-online.target # ネットワークが利用可能になってから起動

[Service]
Type=oneshot # スクリプト実行後、プロセスは終了するためoneshot
ExecStart=/usr/local/bin/robust_script.sh # スクリプトへのフルパス
User=myappuser # スクリプトを実行するユーザー (root権限を避ける)
Group=myappgroup
WorkingDirectory=/opt/myapp # スクリプトの作業ディレクトリ (任意)
StandardOutput=journal # 標準出力をjournaldへ
StandardError=journal  # 標準エラー出力をjournaldへ

# Restart=on-failure # 失敗時に再起動 (oneshotの場合は通常不要だが、長期実行サービスでは有用)

[Install]
WantedBy=multi-user.target # 通常はタイマーから起動されるため、直接有効化は稀

[Unit]
Description=Run My Application Script Every Hour
Documentation=https://example.com/docs/myapp

[Timer]
OnCalendar=hourly # 1時間ごとに実行 (例: "*-*-* *:00:00")

# OnCalendar=minutely # 1分ごとに実行


# OnCalendar=daily # 毎日午前0時に実行


# RandomSec=300 # 実行を最大300秒ランダムに遅延させ、特定の時刻に集中するのを避ける

Persistent=true # タイマーが非アクティブな間に発生したイベントをキャッチして即座に起動

[Install]
WantedBy=timers.target # タイマーを有効にするために必要

sudo install -m 755 robust_script.sh /usr/local/bin/robust_script.sh
sudo systemctl daemon-reload
sudo systemctl enable myapp.timer # タイマーを有効化
sudo systemctl start myapp.timer  # タイマーを起動

journalctl -u myapp.service -f
journalctl -u myapp.timer -f