デプロイ手順

概要

KTblog は Cloudflare Pages にホスティングされている静的HTMLサイト。全675ファイル（672記事 + 5ページ）で構成される。

デプロイコマンド

source ~/clawd/secrets/ktblog.env
cd ~/clawd/ktblog
npx wrangler@3 pages deploy . --project-name=ktblog --branch=main

環境変数

• CLOUDFLARE_API_KEY — Global API Key（環境変数ファイルに保存）
• CLOUDFLARE_EMAIL — Cloudflare アカウントメールアドレス
• CLOUDFLARE_ACCOUNT_ID — アカウントID

最重要ルール

• 常にフルサイトデプロイ — wrangler pages deploy . の . は必須。単一ファイルをデプロイすると全サイトが消滅する
• wrangler v3 必須 — v4 は API Token が必要。v3 は Global API Key で動作
• デプロイ前チェック — bash check.sh で必須ファイルの存在確認

デプロイ後確認

# トップページが表示される
curl -s https://ktblog.pages.dev/ | head -c 200

# デプロイメント一覧
npx wrangler@3 pages deployment list --project-name=ktblog

トラブルシュート

wrangler v4 認証エラー

CLOUDFLARE_API_TOKEN が未設定の場合、wrangler v4 は動作しない。v3 を使用するか、API Token を生成する。

git 検知による上書き

git リポジトリ内からデプロイすると、Cloudflare が git のビルドを実行し、アップロードしたファイルが上書きされる可能性がある。回避するには一時ディレクトリからデプロイするか、wrangler を使用する。