#!/bin/bash

set -euo pipefail # エラー時に即座に終了、未定義変数を使用禁止、パイプライン失敗時に終了

# スクリプト名を取得

SCRIPT_NAME=$(basename "$0")

# 一時ディレクトリの作成と自動削除


# root権限が不要な処理は一般ユーザーで実行し、一時ファイルもユーザーのホームディレクトリや/tmp以下に作成することが推奨されます。


# [出典1] https://mywiki.wooledge.org/BashFAQ/050 (更新日: 2024年05月25日, 著者: Greg's Wiki)

TMP_DIR=$(mktemp -d -t "${SCRIPT_NAME}.XXXXXXXXXX")
log() {
    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1"
}

# エラーハンドリングとクリーンアップ


# SIGINT (Ctrl+C), SIGTERM (終了シグナル), ERR (任意のコマンド失敗) でクリーンアップを実行

trap 'EXIT_CODE=$?; log "スクリプト中断またはエラー (終了コード: $EXIT_CODE)。一時ディレクトリを削除します: $TMP_DIR"; rm -rf "$TMP_DIR"; exit $EXIT_CODE' INT TERM ERR EXIT

log "一時ディレクトリを作成しました: $TMP_DIR"

# ここに主要な処理を記述


# ...

# 処理が正常終了した場合も一時ディレクトリを削除

log "スクリプトが正常に終了しました。"

# trapによってEXITシグナルで削除されるため、明示的なrm -rfは不要だが、コードの明確化のために記述。


# rm -rf "$TMP_DIR" # trapが処理

# 証明書バンドルの指定 (システムデフォルトが推奨されるが、特定のCAが必要な場合)

curl --cacert "/etc/ssl/certs/my_custom_ca.pem" "https://secure.api.example.com/"

# クライアント証明書と秘密鍵の指定 (相互TLS認証の場合)

curl --cert "/path/to/client.crt" --key "/path/to/client.key" "https://mTLS.api.example.com/"

# 名前解決のエラーや特定のホスト名に対してIPアドレスを強制する場合


# [出典2] https://curl.se/docs/manpage.html (更新日: 2024年07月20日, 著者: curl project)

curl --resolve "api.example.com:443:192.0.2.100" "https://api.example.com/data"

# 警告: -k または --insecure はTLS検証を無効にするため、**デバッグ目的以外での利用は避けるべきです。**

# 5秒間隔で最大3回再試行、合計試行時間は60秒まで


# [出典2] https://curl.se/docs/manpage.html (更新日: 2024年07月20日, 著者: curl project)

curl --retry 3 --retry-delay 5 --retry-max-time 60 \
     --fail-with-body \
     "https://unstable.api.example.com/resource"

# --retry: 指定回数だけ再試行。


# --retry-delay: 再試行間の待機秒数。


# --retry-max-time: 再試行を含む全処理の最大時間。


# 指数関数的バックオフは直接サポートされていないため、スクリプト内でロジックを組む必要があります。

# APIリクエストを実行し、その応答をjqで処理する例

API_URL="https://jsonplaceholder.typicode.com/posts/1"

response=$(curl -s "$API_URL")

# 全体を整形して出力

echo "$response" | jq .

# 特定のフィールドを抽出

echo "$response" | jq .title

# 複数のフィールドを抽出し、新しいJSONを生成

echo "$response" | jq '{id: .id, title: .title, userId: .userId}'

# 配列の中から条件に合う要素をフィルタリング


# [出典3] https://jqlang.github.io/jq/manual/ (更新日: 2024年06月15日, 著者: jq project)

echo '[{"id":1, "status":"active"},{"id":2, "status":"inactive"}]' | \
  jq '.[] | select(.status == "active")'

# エラーハンドリング: jq -e を使用して、指定したパスが存在しない場合に非ゼロの終了コードを返す

if echo "$response" | jq -e '.nonExistentField' > /dev/null; then
    log "nonExistentField が存在します"
else
    log "nonExistentField が存在しません" # こちらが実行される
fi

# 例: curlとjqの検証

API_URL="https://jsonplaceholder.typicode.com/todos/1"

# curlでAPIを呼び出し、結果を一時ファイルに保存


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


# -o: 出力を指定したファイルに保存

response=$(curl -s -o "$TMP_DIR/response.json" "$API_URL")
CURL_EXIT_CODE=$?

if [ "$CURL_EXIT_CODE" -ne 0 ]; then
    log "curlコマンドがエラー終了しました (終了コード: $CURL_EXIT_CODE)。詳細はログを確認してください。"
    exit 1
fi

# jq -e で '.title' フィールドの存在を検証


# > /dev/null 2>&1 は出力を抑制し、終了コードのみを利用するため

if ! jq -e '.title' < "$TMP_DIR/response.json" > /dev/null 2>&1; then
    log "応答JSONにtitleフィールドが見つかりませんでした。JSON構造を確認してください。"
    exit 1
fi

log "タイトル: $(jq -r .title < "$TMP_DIR/response.json")"
log "APIコールとJSON処理が成功しました。"

# /etc/systemd/system/myapp.service


# [出典4] https://www.freedesktop.org/software/systemd/man/systemd.unit.html (更新日: 2024年07月01日, 著者: freedesktop.org)


# [出典5] https://www.digitalocean.com/community/tutorials/how-to-schedule-tasks-with-systemd-timers-on-ubuntu-22-04 (更新日: 2024年07月10日, 著者: DigitalOcean)

[Unit]
Description=My Application Data Fetcher
Documentation=https://example.com/docs/myapp
Wants=network-online.target # ネットワークが利用可能であることを保証
After=network-online.target

[Service]
Type=oneshot # 一度実行して終了するタイプのサービス
ExecStart=/usr/local/bin/my_data_fetch_script.sh # 実行するスクリプトのフルパス
User=myappuser # 実行ユーザーを指定。root権限を避けるため重要。
Group=myappgroup # 実行グループを指定。
WorkingDirectory=/home/myappuser/scripts # スクリプトの実行ディレクトリ
StandardOutput=journal # 標準出力をsystemdジャーナルに送る
StandardError=journal  # 標準エラー出力をsystemdジャーナルに送る

# 環境変数が必要な場合は Environment=KEY=VALUE の形式で指定


# Environment="API_KEY=YOUR_API_KEY"


# 失敗時に自動再起動する場合 (Type=simple, Type=exec の場合)


# Restart=on-failure


# RestartSec=5s

[Install]

# Timerユニットから呼び出すため、WantedByセクションは不要またはtimer.targetを設定

# /etc/systemd/system/myapp.timer


# [出典4] https://www.freedesktop.org/software/systemd/man/systemd.timer.html (更新日: 2024年07月01日, 著者: freedesktop.org)


# [出典5] https://www.digitalocean.com/community/tutorials/how-to-schedule-tasks-with-systemd-timers-on-ubuntu-22-04 (更新日: 2024年07月10日, 著者: DigitalOcean)

[Unit]
Description=Run My Application Data Fetcher every 5 minutes
Requires=myapp.service # サービスユニットが存在することを保証

[Timer]
OnBootSec=1min   # システム起動後1分で初回実行
OnUnitActiveSec=5min # 前回のアクティブ化から5分後に実行 (前の実行が完了してから計算)

# OnCalendar=*-*-* *:00:00 # 毎時0分に実行

Persistent=true # タイマーが非アクティブな間に発生したイベントを、タイマーがアクティブ化されたときに実行する

[Install]
WantedBy=timers.target # タイマーが起動時に有効になるように

sudo systemctl daemon-reload           # systemd設定ファイルを再読み込み
sudo systemctl enable --now myapp.timer # myapp.timerを有効化し、すぐに開始
sudo systemctl status myapp.timer      # タイマーのステータスを確認

journalctl -u myapp.service -f # myapp.serviceのログをリアルタイムで追跡
journalctl -u myapp.service --since "2024-07-31" # 2024年07月31日以降のログから確認 (JST)