Gadget 51:ヘッドレス運用
UI を開かず CLI / cron で Cloudflare OS を操作・自動化する
ヘッドレス運用
ブラウザを開かずに、コマンドとスケジューラで OS を操ります。
目的
- UI 操作を API/CLI に置き換え、自動化の素地を作る
- 夜間バッチ・定期チェック(26)を進化させる
前提条件
- 起動環境とログ(05)
- 自動化の基礎(26-automation-scripts)
手順
1. 操作対象を把握する
Cloudflare OS の UI はバックエンド API(Workers の Worker)に対して呼び出しています。 「どの URL に何を POST/PATCH しているか」を DevTools で確認 → 自動化の入口になります。
# まず生きているか
curl -sf http://localhost:8787 >/dev/null && echo OK2. 最小の自動操作(例)
# ヘルスチェック+ログ抽出+S3/FTP アップロード
curl -sf http://localhost:8787/api/health && \
tail -n 20 <cfos.log> | tee /tmp/cfos-daily.txt
TipAPI の把握方法
UI の DevTools(Network タブ)で実際のリクエストを見るのが最速です。 整理した結果をアプリ/作業メモに残すと、自分専用 API メモができます。
3. スケジューラと結合
10 3 * * * /usr/local/bin/cfos-headless-daily.sh
よくある失敗
| 症状 | 原因 | 対処 |
|---|---|---|
| 401・認証が弾かれる | 未認証で API を叩いた | 認証(セッション/トークン)の扱いを確認 |
| URL が変わって壊れる | UI 更新で API 変更 | メモを更新し、バージョンを記録 |
| スクリプト暴走 | 多重起動 | pgrep で二重走行防止(26) |
| 自動化が機密を露出 | ログに token | 出力前に Secret をマスク |
確認
次に読む
- 自動化 → 26-automation-scripts
- 監視 → 18-monitoring-and-alerting
- デバッグ → 52-debugging-hacks