wrangler
Cloudflare Workersのwranglerコマンドを管理する。D1データベース、R2ストレージ、シークレット、Workers開発・デプロイ時に使用。「D1」「R2」「デプロイ」「wrangler」「Cloudflare」などのキーワードで発動。
When & Why to Use This Skill
This Claude skill provides a comprehensive interface for managing Cloudflare Workers and the surrounding ecosystem via the Wrangler CLI. It streamlines the entire serverless development lifecycle, from local environment setup and real-time log monitoring to production deployment, D1 database migrations, and R2 storage management. By integrating these infrastructure tasks directly into the AI workflow, it enables developers to manage cloud resources and secrets with high efficiency and precision.
Use Cases
- Deploying and rolling back Cloudflare Workers: Quickly deploy code to production or revert to previous versions using simple natural language commands.
- D1 Database Management: Execute SQL queries, manage database schemas, and perform migrations for Cloudflare's serverless SQL database.
- R2 Storage Operations: Create and manage buckets, upload or delete objects, and configure lifecycle rules for Cloudflare's S3-compatible storage.
- Real-time Debugging and Monitoring: Use the 'tail' command to monitor live logs, filter for errors, and debug serverless functions in real-time.
- Secure Secret Management: Interactively set, list, and update environment secrets and API keys without exposing sensitive data in command history.
| name | wrangler |
|---|---|
| description | Cloudflare Workersのwranglerコマンドを管理する。D1データベース、R2ストレージ、シークレット、Workers開発・デプロイ時に使用。「D1」「R2」「デプロイ」「wrangler」「Cloudflare」などのキーワードで発動。 |
Wrangler CLI管理
Cloudflare Workers開発のためのwranglerコマンドを管理するスキル。
重要な制約
このスキルは sh1ma/blog リポジトリのみで使用すること。
他のプロジェクトへの操作は禁止。
Workers開発・デプロイ
開発サーバー起動
wrangler dev # ローカル開発サーバー起動
wrangler dev --remote # リモートリソースに接続して開発
wrangler dev --local # 完全ローカルモード
wrangler dev --port 8787 # ポート指定
デプロイ
wrangler deploy # Workerをデプロイ
wrangler deploy --dry-run # ドライラン(実際にはデプロイしない)
wrangler deploy --env production # 環境指定
ログ監視
wrangler tail # リアルタイムログ監視
wrangler tail --format pretty # 整形表示
wrangler tail --status error # エラーのみフィルタ
wrangler tail --search "keyword" # キーワードフィルタ
バージョン管理
wrangler deployments list # デプロイ履歴一覧
wrangler rollback # 前バージョンにロールバック
wrangler rollback <version-id> # 特定バージョンにロールバック
D1データベース
データベース操作
wrangler d1 list # D1データベース一覧
wrangler d1 info <name> # データベース情報
wrangler d1 create <name> # データベース作成
wrangler d1 delete <name> # データベース削除
SQLクエリ実行
wrangler d1 execute <db> --command "SELECT * FROM users" # SQL実行
wrangler d1 execute <db> --file schema.sql # SQLファイル実行
wrangler d1 execute <db> --command "..." --local # ローカルDB対象
wrangler d1 execute <db> --command "..." --remote # リモートDB対象
wrangler d1 execute <db> --command "..." --json # JSON出力
マイグレーション
wrangler d1 migrations list <db> # マイグレーション一覧
wrangler d1 migrations create <db> <message> # マイグレーション作成
wrangler d1 migrations apply <db> # マイグレーション適用
wrangler d1 migrations apply <db> --local # ローカルに適用
wrangler d1 migrations apply <db> --remote # リモートに適用
エクスポート・タイムトラベル
wrangler d1 export <db> --output backup.sql # データエクスポート
wrangler d1 time-travel restore <db> # ポイントインタイムリストア
R2ストレージ
バケット管理
wrangler r2 bucket list # バケット一覧
wrangler r2 bucket create <name> # バケット作成
wrangler r2 bucket info <bucket> # バケット情報
wrangler r2 bucket delete <bucket> # バケット削除
オブジェクト操作
wrangler r2 object get <bucket>/<key> # オブジェクト取得
wrangler r2 object put <bucket>/<key> # オブジェクトアップロード
wrangler r2 object delete <bucket>/<key> # オブジェクト削除
バケット設定
wrangler r2 bucket lifecycle list <bucket> # ライフサイクルルール一覧
wrangler r2 bucket cors list <bucket> # CORS設定一覧
wrangler r2 bucket notification list <bucket> # 通知設定一覧
シークレット管理
wrangler secret list # シークレット一覧
wrangler secret put <key> # シークレット設定(対話式)
wrangler secret delete <key> # シークレット削除
wrangler secret bulk secrets.json # 一括設定(JSONファイル)
シークレットJSON形式
{
"API_KEY": "your-api-key",
"DATABASE_URL": "your-database-url"
}
認証・アカウント
wrangler login # Cloudflareにログイン
wrangler logout # ログアウト
wrangler whoami # 認証状態確認
型生成
wrangler types # TypeScript型定義を生成
実行手順
- ユーザーの要求を理解する
- 適切なwranglerコマンドを選択・実行
- 結果を日本語で報告
注意事項
--localはローカル開発用、--remoteは本番環境用- D1マイグレーションは
migrations/ディレクトリに配置 - シークレットは
wrangler secret putで対話的に設定(コマンドラインに値を含めない) - 他プロジェクトへの操作は絶対に行わない