アプリを自分の Cloudflare アカウントで動かす
要点「バックエンド → クラウド」で Cloudflare の API トークンを接続すると、アプリを MonstarX ではなく自分の Cloudflare アカウントで動かせます。Worker、D1 データベース、ドメイン、請求はすべてあなたのものです。アプリのコードでは、MonstarX があなたのアカウントに作成する KV、R2、Queues、Vectorize、Workers AI などの Cloudflare のサービスも使えます。
MonstarX は、すべてのアプリを自身のクラウドで公開します。あなたが管理するものは何もありません。すでに会社で Cloudflare を使っている場合や、アプリ、データ、請求を自分の名義にしたい場合は、Cloudflare アカウントを接続しましょう。変わるのは次の2点です。
- ホスティング。 公開すると、アプリはあなたの Cloudflare アカウントに置かれます。Worker(アプリを配信するプログラム)、D1 データベース(Cloudflare の SQL データベース)、ドメイン、請求はすべてあなたのものです。
- Cloudflare のサービス。 アプリのコードで、ストレージ、キュー、AI など Cloudflare のほかのサービスを使えます。MonstarX があなたのアカウントに用意します。
Cloudflare の API トークンが必要です。Cloudflare で Manage Account → API Tokens を開き、Edit Cloudflare Workers テンプレートからトークンを作成して、D1: Edit を追加します。アプリで使いたい追加のサービスごとに、権限を追加してください。
| サービス | 用途 | 追加する権限 |
|---|---|---|
| KV | 設定、キャッシュ、機能フラグ、短期間だけ使うトークン向けの高速なキーバリューストア | Workers KV Storage: Edit |
| R2 | ダウンロードに料金がかからないファイルストレージ。アップロード、画像、エクスポート、バックアップに | Workers R2 Storage: Edit |
| Queues | バックグラウンド処理。リクエスト内で仕事を渡し、後から再試行付きで仕上げます | Queues: Edit |
| Vectorize | 意味で検索するためのベクトルインデックス | Vectorize: Edit |
| Workers AI | テキスト、埋め込み、画像用のオープンな AI モデル。料金はあなたに請求されます | Workers AI: Edit |
| Browser Rendering | スクリーンショット、PDF、あらゆるページの本文テキストを得るための本物のブラウザ | Browser Rendering: Edit |
| Images | 画像の保存とリサイズ。バリアントと配信用のアドレス付き | Cloudflare Images: Edit |
| Analytics Engine | 独自のイベントを量を気にせず記録し、SQL で集計 | Account Analytics: Read |
Cloudflare アカウントを接続するには?
Section titled “Cloudflare アカウントを接続するには?”-
プロジェクトを開き、上部のバーで バックエンド をクリックし、続けて クラウド をクリックします。
-
コネクタ で Cloudflare の横の 接続する をクリックします(まだトークンを作っていなければ、トークンを作成 で Cloudflare のトークンのページが開きます)。
-
トークンを API トークン に貼り付け、Cloudflare を接続 をクリックします。
-
トークンで複数のアカウントにアクセスできる場合は、アプリを動かすアカウントを選んで このアカウントを使う をクリックします。MonstarX がトークンでアカウントの一覧を取得できない場合は、アカウント ID(32文字で、Cloudflare のダッシュボードに表示されています)を求められます。
続いて MonstarX は、トークンで何ができるかを確認します。Workers と D1 の権限がなければ接続せず、追加すべき権限を具体的に示します。追加のサービスの権限が足りない場合は「このトークンでは … にアクセスできません」と表示されますが、それ以外はそのまま使えます。
自分のアカウントに公開するには?
Section titled “自分のアカウントに公開するには?”接続すると、バックエンドクラウド の Cloudflare のカードにアカウントと このアプリを自分の Cloudflare で動かす のスイッチが表示されます。オンにすると、公開 にアプリを「あなたの Cloudflare アカウント」にデプロイすることが、アカウントとアドレスとともに表示されます。
公開すると、次のことが行われます。
- MonstarX がプロジェクト名に合わせた D1 データベースをあなたのアカウントに作り(同じ名前のものがあればそれを使い)、アプリに必要なテーブルをすべて用意します。
- アプリをビルドし、アプリ名に合わせた Worker としてアップロードします。
- アプリは
your-app.your-subdomain.workers.dev、または自分のドメインで公開されます。
自分のドメインを使うには、Cloudflare のカードで 自分のドメインを使う をクリックします。Cloudflare アカウントにあるドメインが一覧になるので、1つ選んで アドレス(ドメインそのもの、またはそのサブドメイン)を入力し、このアドレスを使う をクリックします。DNS レコードと HTTPS 証明書は Cloudflare が追加します。変更は次に公開したときに反映されます。workers.dev を使う で元に戻せます。
アプリで Cloudflare のサービスを使うには?
Section titled “アプリで Cloudflare のサービスを使うには?”「アップロードされた写真を R2 に保存して」「メニューを KV にキャッシュして」「Workers AI でレビューを要約して」のように、やりたいことを頼みます。MonstarX があなたのアカウントにサービスを作り(プロジェクト名に合わせた名前で、同じ名前のものがあればそれを使います)、アプリにつないで、コードを書きます。プレビューでもすぐに動きます。
Cloudflare のカードにある Cloudflare のサービス の一覧で、自分で管理することもできます。追加 でサービスを選び、uploads や sessions のような短い名前を付けて 作成 をクリックします。使用をやめる を押すとアプリからサービスの接続を外しますが、Cloudflare 上では何も削除されず、データはあなたのアカウントに残ります。
知っておくと便利なこと
Section titled “知っておくと便利なこと”- 上限も請求もあなたのものです。 アプリが使った分は、Cloudflare からあなたのアカウントに請求されます。Cloudflare のリクエストの上限はアカウントごとなので、あなたのアカウントのアプリが忙しくなってもほかの人のアプリが遅くなることはなく、その逆もありません。
- 公開を停止すると、あなたのアカウントから Worker が削除されます。D1 データベースやほかのサービスは残ります。
- アカウントの変更や接続解除は、アプリがそこで公開されている間はできません。先に公開を停止するか、このアプリを自分の Cloudflare で動かす をオフにして公開してください。アプリをあなたのアカウントに移したり、そこから移したりすると、以前の場所にあった Worker は削除されます。
- データが Supabase や Railway にある場合は、アプリはそのデータベースを使い続け、D1 データベースは作られません。
- インポートしたアプリは、そのアプリ自身のビルドで作られる静的ファイルとしてあなたのアカウントに公開されます。データベースは付かず、Cloudflare のサービス用のヘルパーも使えません。
- エクスポートにも同じ Cloudflare の設定が含まれるので、ダウンロードしたコードから
wrangler deployを実行すれば同じサービスにつながります。詳しくは コードをエクスポートする をご覧ください。
よくある質問
Section titled “よくある質問”トークンにはどんな権限が必要ですか?
Cloudflare の Edit Cloudflare Workers テンプレートから始めて、D1: Edit を追加してください。追加のサービスごとに、R2 なら Workers R2 Storage: Edit のように権限を追加します。
公開中のアプリのデータがプレビューと違うのはなぜですか?
自分の Cloudflare アカウントでは、公開中のアプリは専用の D1 データベースを持ち、それは空の状態から始まります。プレビューは MonstarX 側の練習用データを使い続けるので、本物のお客さんのレコードに触れずにテストできます。
自分のドメインを使えますか?
はい、そのドメインが自分の Cloudflare アカウントにあれば使えます。Cloudflare のカードで 自分のドメインを使う をクリックし、ドメインを選んでアドレスを入力し、もう一度公開してください。
MonstarX が私の Cloudflare アカウントのものを削除することはありますか?
公開を停止したときや、アプリをアカウントから移したときに、アプリの Worker を削除するだけです。使用をやめる でデータベースやサービスが削除されることはありません。
MonstarX のホスティングに戻せますか?
はい。このアプリを自分の Cloudflare で動かす をオフにして、もう一度公開してください。アプリが MonstarX で動くようになると、あなたのアカウントの Worker は削除されます。