Zenn
👌

Cloudflare Workers によるエッジ API 構築体験 調査結果

に公開
TypeScript
API
Cloudflare
Serverless
Cloudflare Workers
tech

調査日

2025年5月1日（木）

調査目的

Cloudflare Workers を用いて、世界中で高速に応答可能なサーバレス API を構築・公開し、開発からデプロイまでの流れを体験する。

実施環境

  • OS: Windows 11
  • Node.js: 20.x
  • wrangler: 4.13.2
  • Cloudflare アカウント: 無料プラン
  • プロキシ環境: 有り（環境変数による自動検出）
  • ブラウザ: Google Chrome

手順

1. wrangler のインストールと認証

npm install -g wrangler
wrangler login

ブラウザで Cloudflare アカウント連携を許可後、CLI で認証成功。

2. プロジェクト作成

wrangler init hello-worker

対話形式の選択肢:

  • テンプレート: Hello World example
  • 種類: Worker only
  • 言語: TypeScript
  • Git 管理: No
  • 初期デプロイ: No

3. src/index.ts の編集

export default {
  async fetch(request: Request): Promise<Response> {
    return new Response('Hello from Cloudflare Worker!', {
      headers: { 'content-type': 'text/plain' },
    });
  },
};

4. ローカル確認

wrangler dev

ブラウザで http://localhost:8787 にアクセスし、以下のレスポンスを確認：
Hello from Cloudflare Worker!

5. 本番デプロイとサブドメイン登録

wrangler deploy

初回デプロイ時に houmatsu-worker.workers.dev を登録。
デプロイ先 URL：

https://hello-worker.houmatsu-worker.workers.dev

DNS 伝播後にアクセス成功。

結果と確認内容

項目 状態
Wrangler 導入 成功
Cloudflare 認証 成功
ローカル開発 成功（即時応答確認）
本番デプロイ 成功（サブドメイン登録あり）
公開 URL アクセス 成功（DNS 反映まで約10分）

所感と課題

  • 初期構築から公開まで約30分で完了
  • サーバレスかつグローバルに展開できる開発体験は非常に快適
  • DNS 伝播の待機時間は初回のみで、それ以外は高速
  • wrangler v4 以降は publish でなく deploy を使用
  • wrangler open コマンドは廃止されている点に注意

今後の検討事項

  • Cloudflare Workers KV や Durable Objects を用いたステート管理
  • REST API エンドポイント化および JSON レスポンス対応
  • GitHub Actions との連携による CI/CD パイプライン構築
  • 独自ドメインとの連携による実用 API 提供の実現

Discussion