#!/bin/bash


# Bashスクリプトの堅牢なテンプレート

# 1. 堅牢な実行オプション


# -e: コマンドが失敗した場合、即座にスクリプトを終了


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


# -o pipefail: パイプライン中のコマンドが一つでも失敗した場合、パイプライン全体の終了ステータスを非ゼロにする

set -euo pipefail

# 2. 一時ディレクトリの作成とクリーンアップ


# mktemp -d: 安全な一時ディレクトリを作成し、そのパスを変数に格納


# EXITトラップ: スクリプト終了時（正常終了、エラー終了問わず）に一時ディレクトリを削除

TMPDIR=$(mktemp -d -t my-app-XXXXXXXX)
log_info() { echo "$(date +'%Y-%m-%d %H:%M:%S') [INFO] $1"; }
log_error() { echo "$(date +'%Y-%m-%d %H:%M:%S') [ERROR] $1" >&2; }

trap 'rm -rf "$TMPDIR"; log_info "一時ディレクトリ $TMPDIR を削除しました。"' EXIT
log_info "一時ディレクトリ $TMPDIR を作成しました。"

# ここにスクリプトのメイン処理を記述


# ...

#!/bin/bash


# ... (前述の基本構造を継続) ...

# 冪等性チェックの例


# 例: 特定のファイルが存在するかどうかで処理の要否を判断

TARGET_FILE="/opt/my-app/data/processed_flag_$(date +%Y%m%d).txt"

if [ -f "$TARGET_FILE" ]; then
    log_info "処理済みフラグ $TARGET_FILE が存在するため、本日の処理はスキップします。"
    exit 0 # 冪等なスキップ
fi

log_info "本日の処理を実行します。"

# メイン処理を開始


# ...

touch "$TARGET_FILE" # 処理完了後にフラグファイルを作成
log_info "処理済みフラグ $TARGET_FILE を作成しました。"

#!/bin/bash


# ... (前述の基本構造を継続) ...

log_info "JSONデータの処理を開始します。"

# ダミーのJSONデータ（実際のスクリプトではcurlなどから取得）


# 入力: 標準入力またはファイルからJSONを受け取る


# 出力: 抽出された値


# 複雑度: O(N) - JSONのサイズに比例


# メモリ: JSONサイズに依存

JSON_DATA='{"status": "success", "data": {"id": "123", "name": "Test Item", "value": 100}}'

# jqでデータを抽出する例


# -r: raw output (引用符なしで文字列を出力)

STATUS=$(echo "$JSON_DATA" | jq -r '.status')
ITEM_NAME=$(echo "$JSON_DATA" | jq -r '.data.name')
ITEM_VALUE=$(echo "$JSON_DATA" | jq -r '.data.value')

if [ "$STATUS" == "success" ]; then
    log_info "ステータス: $STATUS"
    log_info "アイテム名: $ITEM_NAME"
    log_info "アイテム値: $ITEM_VALUE"
else
    log_error "JSON処理中にエラーが発生しました。ステータス: $STATUS"
    exit 1
fi

#!/bin/bash


# ... (前述の基本構造を継続) ...

log_info "外部API連携を開始します。"

API_URL="https://api.example.com/data"
API_TOKEN="your_api_token"
MAX_RETRIES=5
RETRY_DELAY=5 # 秒
BACKOFF_FACTOR=2

# 入力: API_URL, API_TOKEN


# 出力: APIレスポンス（JSON形式）


# 複雑度: O(MAX_RETRIES) - 最大リトライ回数


# メモリ: レスポンスサイズに依存

for i in $(seq 1 "$MAX_RETRIES"); do
    log_info "API呼び出し試行 $i/$MAX_RETRIES..."

    # --fail-with-body: HTTPステータスが2xxでない場合にエラー終了し、レスポンスボディも出力


    # --show-error: エラー発生時に詳細を表示


    # --silent: 進行状況メーターなどを表示しない


    # --connect-timeout: 接続確立のタイムアウト


    # --max-time: 全体の転送タイムアウト


    # --header: リクエストヘッダ


    # --cacert: CA証明書パス (プロダクション環境では必須。省略するとOSの信頼ストアを利用)


    #           本番環境では必ず適切なCA証明書を配置するか、OS標準の証明書ストアを利用する設定を推奨


    #           例: --cacert /etc/ssl/certs/ca-certificates.crt

    API_RESPONSE=$(curl \
        --fail-with-body \
        --show-error \
        --silent \
        --connect-timeout 10 \
        --max-time 30 \
        --header "Authorization: Bearer $API_TOKEN" \
        "$API_URL" || true) # エラー時にもスクリプトが即終了しないように一時的に '|| true' を使用

    CURL_STATUS=$?

    if [ "$CURL_STATUS" -eq 0 ]; then
        log_info "API呼び出し成功。"
        echo "$API_RESPONSE" | jq '.' > "$TMPDIR/api_response.json"
        log_info "APIレスポンスを $TMPDIR/api_response.json に保存しました。"

        # ここでAPIレスポンスをjqで処理する


        # ...

        break
    else
        log_error "API呼び出し失敗 (curl exit code: $CURL_STATUS)。レスポンス: $API_RESPONSE"
        if [ "$i" -lt "$MAX_RETRIES" ]; then
            SLEEP_TIME=$((RETRY_DELAY * (BACKOFF_FACTOR**(i-1))))
            log_info "${SLEEP_TIME}秒待機してリトライします..."
            sleep "$SLEEP_TIME"
        else
            log_error "最大リトライ回数に達しました。処理を終了します。"
            exit 1
        fi
    fi
done

#!/bin/bash


# ...

# root権限が必要な特定のコマンドの例


# log_info "重要なファイルを作成します（sudoが必要です）。"


# sudo -u root install -m 600 /path/to/my_config.conf /etc/my_app/config.conf


# log_info "ファイル /etc/my_app/config.conf を作成しました。"

# 不用意なroot実行を防ぐ

if [ "$EUID" -eq 0 ]; then
   log_error "本スクリプトはroot権限での直接実行を推奨しません。必要に応じてsudo -uをご利用ください。"

   # exit 1 # 強制終了させる場合はコメントを外す

fi

[Unit]
Description=My Application Daily Task
Documentation=https://example.com/docs/my-app-task
After=network.target

[Service]

# Type=oneshot: 1回限りの実行を想定

Type=oneshot

# User: スクリプトを実行するユーザー（root以外を推奨）

User=myuser

# WorkingDirectory: スクリプトの実行ディレクトリ

WorkingDirectory=/opt/my-app

# ExecStart: 実行するスクリプトへのフルパス


#           ExecStartPreで冪等性フラグのリセットなど、前処理も可能

ExecStart=/bin/bash /opt/my-app/scripts/my-task.sh

# StandardOutput, StandardError: ログの出力先。journaldに送る

StandardOutput=journal
StandardError=journal

# Restart: 失敗時の再起動ポリシー (今回はoneshotのため通常不要)

Restart=no

# ProtectHome, ReadOnlyPathsなど、セキュリティ強化オプション


# NoNewPrivileges=yes: ExecStartのプロセスが追加の権限を取得することを禁止

NoNewPrivileges=yes

# PrivateTmp=yes: 専用の一時ディレクトリを付与

PrivateTmp=yes

[Install]

# WantedBy: timerが有効化された際に、このサービスも有効化される

WantedBy=timers.target

[Unit]
Description=Run My Application Daily Task every day
Requires=my-app-task.service

[Timer]

# OnCalendar: タイマーの発火スケジュール (例: 毎日午前3時)


#       UTCではなくJSTなどのローカルタイムで動作

OnCalendar=*-*-* 03:00:00

# Persistent=true: タイマー停止中にスケジュールされた実行があった場合、起動時に即座に実行

Persistent=true

[Install]

# WantedBy: systemctl enableコマンドで有効化されるターゲット

WantedBy=timers.target

# systemd設定ファイルをリロード

sudo systemctl daemon-reload

# タイマーを有効化し、起動

sudo systemctl enable my-app-task.timer
sudo systemctl start my-app-task.timer

# サービスの状態確認

sudo systemctl status my-app-task.service

# タイマーの状態確認

sudo systemctl status my-app-task.timer

# 実行ログの確認


# -u: ユニット名でフィルタリング


# -f: 最新のログをリアルタイムで追跡

sudo journalctl -u my-app-task.service -f