Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

はじめに

最終更新 Markdown で表示Agent セットアップ

ほとんどのフロントエンドアプリケーションでは、フレームワークを使います。Workers は、すぐに使えるコンポーネント、あらかじめ決まった構成、コミュニティサポートを備えた、多くの人気 フレームワーク をサポートします。フレームワークの利用を始めるには、フレームワーク別ガイド を参照してください。

一方、次のような場合は、サイトを一から作る方が向いていることがあります。

  • 中核機能を自分で実装して学びたい。
  • フレームワークが不要な、簡単なプロジェクトである。
  • 外部依存を減らしてパフォーマンスを最適化したい。
  • アプリケーションのあらゆる側面を完全に制御したい。
  • 自分でフレームワークを作りたい。

このガイドでは、フレームワークなしで静的サイトまたはフルスタックアプリケーションをセットアップし、Workers にデプロイする手順を説明します。

静的サイトをデプロイする

このガイドでは、Workers 上で静的サイトをセットアップしてデプロイする手順を説明します。

1. CLI で新しい Worker プロジェクトを作成する

C3(create-cloudflare-cli は、Cloudflare 向けの新しいアプリケーションのセットアップとデプロイを助けるコマンドラインツールです。ターミナルを開き、C3 を実行して Worker プロジェクトを作成します。

npm create cloudflare@latest -- my-static-site

セットアップでは、次のオプションを選びます。

  • What would you like to start with? では、Hello World example を選びます。
  • Which template would you like to use? では、Static site を選びます。
  • Which language do you want to use? では、TypeScript を選びます。
  • Do you want to use git for version control? では、Yes を選びます。
  • Do you want to deploy your application? では、No を選びます(デプロイ前にいくつか変更します)。

プロジェクトのセットアップ後、次のコマンドでディレクトリを切り替えます。

cd my-static-site

2. ローカルで開発する

Worker を作成したら、プロジェクトディレクトリで wrangler dev を実行してローカルサーバーを起動します。開発中にプロジェクトをローカルでプレビューできます。

npx wrangler dev

3. プロジェクトをデプロイする

プロジェクトは、自分のマシンからも、Cloudflare 独自の CI/CD を含む任意の CI/CD システムからも、*.workers.dev サブドメインまたは カスタムドメイン にデプロイできます。

wrangler deploy は、プロジェクトをビルドしてデプロイします。CI を使う場合は、デプロイコマンド の設定を適切に更新してください。

npx wrangler deploy

フルスタックアプリケーションをデプロイする

このガイドでは、動的で対話的なサーバーサイドレンダリング(SSR)アプリケーションを Cloudflare Workers にセットアップしてデプロイする手順を説明します。

フルスタックアプリケーションを作るときは、任意の Workers バインディングアセット自身のバインディング を含む)を使い、Cloudflare Developer Platform 上のリソースとやり取りできます。

1. 新しい Worker プロジェクトを作成する

C3(create-cloudflare-cli は、Cloudflare 向けの新しいアプリケーションのセットアップとデプロイを助けるコマンドラインツールです。

ターミナルを開き、C3 を実行して Worker プロジェクトを作成します。

npm create cloudflare@latest -- my-dynamic-site

セットアップでは、次のオプションを選びます。

  • What would you like to start with? では、Hello World example を選びます。
  • Which template would you like to use? では、SSR / full-stack app を選びます。
  • Which language do you want to use? では、TypeScript を選びます。
  • Do you want to use git for version control? では、Yes を選びます。
  • Do you want to deploy your application? では、No を選びます(デプロイ前にいくつか変更します)。

プロジェクトのセットアップ後、次のコマンドでディレクトリを切り替えます。

cd my-dynamic-site

2. ローカルで開発する

Worker を作成したら、プロジェクトディレクトリで wrangler dev を実行してローカルサーバーを起動します。開発中にプロジェクトをローカルでプレビューできます。

npx wrangler dev

3. プロジェクトを変更する

生成されたプロジェクトが動いている状態で、プロジェクトの編集を始められます。

  • src/index.ts ファイルにはサンプルコードが入っています。内容を変更すると、Worker のサーバー側の動作が変わります。
  • public/index.html ファイルにはサンプルコードが入っています。この内容、または public/ 内のほかのファイルを変更すると、Worker の静的アセットが変わります。

ファイルを保存してページを再読み込みします。変更内容に応じて、プロジェクトの出力が変わります。

4. プロジェクトをデプロイする

プロジェクトは、自分のマシンからも、Cloudflare 独自の CI/CD を含む任意の CI/CD システムからも、*.workers.dev サブドメインまたは カスタムドメイン にデプロイできます。

wrangler deploy は、プロジェクトをビルドしてデプロイします。CI を使う場合は、デプロイコマンド の設定を適切に更新してください。

npx wrangler deploy

役に立ちましたか?