サーバーWorkflowsWorkersQueues料金・無料枠

Cloudflare Workflowsとは?手順を確実に進める仕組みと料金

フレアはゆるフレアはゆる
こんな人におすすめ
・複数のAPIを呼ぶ処理が途中で失敗して困る
・数日後のメール送信や承認待ちを作りたい
・QueuesとWorkflowsの違いを知りたい

Cloudflare Workflows は、Workers の上で複数の手順(ステップ)を順に進め、結果を保存しながら、失敗した手順だけを自動でやり直す仕組みです。数日後に続きを実行する処理や、Webhook・人の承認を待つ処理も、キューや cron を自分で組み合わせずに書けます。Workers の無料プランでも使えます。

この記事では、ステップの仕組み、待つ・取り消す機能、Queues・Cron Triggers との違い、料金と無料枠、始め方、注意点を扱います。数値は Workflows の公式ドキュメント などで2026年11月に確かめたものです。

この記事のゴール(読了目安 約8分)

Workflowsの仕組みと料金を知り、Queuesと比べて自分の処理に使うか判断できるようになる

Workflowsとは?手順を確実に進める仕組み

Workflows は、処理が途中で止まっても、保存しておいた状態から続きを実行するための仕組みです。インフラの管理は要りません。

複数の手順をつなぎ、失敗した処理を自動でやり直し、状態を数分から数週間まで保てます。この作り方を Durable Execution(途中で止まっても、保存した状態から続きを実行する作り方)と呼びます。

公式ブログは、数日たっても購入されないカートへのリマインドメールを例にしています。ふつうはキュー、cron ジョブ、データベースの定期検索を組み合わせる処理です。Workflows なら、カートごとに Workflow を1つ起動し、3日待ってからカートを確かめるだけで作れます。

公式が挙げる用途は次の4つです。

  • AI を使ったアプリ
  • データパイプライン(データを順に加工して流す処理)
  • 自動メールやトライアル期限の管理
  • 人の承認を挟む仕組み

Workflows は、Workers の無料プランと有料プランのどちらでも使えます。

仕組み:ステップごとに結果を保存する

Workflows の動きは、次の4つの用語で説明できます。

用語意味例
Workflow手順を書いた定義(クラス)注文処理
インスタンス1回起動した1件分の実行。上限なく作れる注文1件ごとの実行
ステップ結果を保存し、失敗したらそこだけやり直す単位在庫の確保
イベント起動するときに渡すデータ注文 ID

ステップは step.do(名前, 処理) で書き、処理の結果を保存します。中断や再試行のときは、最後に成功したステップから再開します。完了したステップの処理は、再開しても実行し直しません。

Workflow は WorkflowEntrypoint を継承したクラスで作ります。公式の Get started のコードを短くすると、次の形です。

import { WorkflowEntrypoint } from "cloudflare:workers";

export class MyWorkflow extends WorkflowEntrypoint {
  async run(event, step) {
    // 1つ目のステップ:API からデータを取る(結果は保存される)
    const data = await step.do("fetch data", async () => {
      const res = await fetch("https://api.cloudflare.com/client/v4/ips");
      return res.json();
    });

    // 20秒待つ
    await step.sleep("pause", "20 seconds");

    // 2つ目のステップ:再試行の設定を付けて処理する(中身は省略)
    return await step.do(
      "process data",
      { retries: { limit: 3, delay: "5 seconds", backoff: "linear" } },
      async () => {
        // data などから name と ipCount を作って返す
      },
    );
  }
}

状態はステップの戻り値で残します。待つ間にインスタンスが休止して、メモリ上の状態を失うことがあるためです。

Workflows は Workers の上に作られ、内部では SQLite を使う Durable Objects を利用しています。Durable Objects そのものは Durable Objectsとは?状態を1か所に集める仕組みと料金 で解説しています。

Worker が create() で Workflow のインスタンスを起動する。インスタンスはステップごとに結果を状態として保存し、失敗しても保存した状態から続きを実行する。status() で状態を返す
ステップごとに結果を保存するので、失敗しても済んだ手順は飛ばして続きから進みます。

できること:待つ・やり直す・取り消す

ステップの中で使える主な機能は「待つ」「やり直す」「取り消す」の3つです。2026年11月時点の公式ページの既定値と上限は次のとおりです。

機能使うもの既定値・上限
時間で待つstep.sleep・step.sleepUntil最長365日
イベントを待つstep.waitForEvent既定24時間、最長365日
やり直すstep.do の設定既定5回、1回10分で打ち切り
取り消すロールバック済んだステップを逆の順に取り消す

イベント待ちは、Webhook や人の承認を受けて続きを進めるときに使います。時間切れになるとインスタンスは失敗します。

再試行の回数や間隔は、ステップごとに変えられます。認証の失敗のように、やり直しても直らないエラーは NonRetryableError ですぐ失敗にします。

2026年6月から使えるロールバック(失敗したときに、済んだ手順を取り消す処理)は、在庫の確保や支払いの承認のように、外部のシステムに触れる処理に向きます。

待っている(waiting の)インスタンスは同時実行数に入らないので、多くのインスタンスを待たせておけます。

Queues・Cron Triggersとの違い

1件ずつ確実に届けるなら Queues、時刻で動かすなら Cron Triggers、手順を状態ごと進めるなら Workflows が向きます。

やりたいこと向く仕組み理由
依頼を1件ずつ確実に届けるQueues1件ずつ完了・再試行・追跡できる
決まった時刻に Worker を動かすCron Triggers1回の経過時間(待ち時間を含む)は15分まで
手順を順に進め、待ったりやり直したりするWorkflowsステップの経過時間に上限がない(CPU 時間の上限はある)

再試行の既定は、Queues がメッセージごとに3回、Workflows がステップごとに5回です。

左は Queues で、依頼のメッセージを1件ずつ届け、メッセージごとに再試行する。右は Workflows で、複数の手順を順に進め、失敗した手順だけやり直す
Queues は依頼を1件ずつ確実に届け、Workflows は複数の手順を状態ごと進めます。

3つは組み合わせても使えます。

  • キューのコンシューマー(受け取る側)から Workflow を起動する
  • Workflow の開始・エラー・完了の知らせをキューで受け取る
  • Workflow の設定の schedules で、決まった時刻に起動する

schedules は2026年6月からの機能で、scheduled ハンドラーを持つ Worker を別に作らずに済みます。cron 式(動かす時刻を決める書き方)は Cron Triggers の解説記事 で扱います。キューの仕組みは Cloudflare Queuesとは?非同期処理の仕組みと無料枠・料金 で解説しています。

料金と無料枠:4つの数え方

料金は、CPU 時間・リクエスト(起動の回数)・保存量・ステップ数の4つで数えます。2026年11月時点の公式ページの数字は次のとおりです。

項目Workers FreeWorkers Paid
起動の回数1日10万(Workers と共通)月1,000万込み、超過100万あたり0.30ドル
CPU 時間10ミリ秒月3,000万 CPU ミリ秒込み、超過100万 CPU ミリ秒あたり0.02ドル
保存量1 GB-月1 GB-月込み、超過1 GB-月あたり0.20ドル
ステップ数1日3,000月50万込み、超過10万あたり0.80ドル
最低料金なし月5ドル(Workers 有料プラン)

起動は新しいインスタンスを作ることで、ステップは起動に数えません。GB-月は、日ごとの最大の保存量を30日で平均した単位です。

API の応答待ちや step.sleep の間は、CPU 時間に数えません。 ただし課金の告知は、sleep やイベント待ちもステップに含めるとしています。保存量には、休止中や完了したインスタンスの状態も入ります。再試行とロールバックは、ステップ数に含みません。

ステップ数と保存量の課金は、公式の料金ページでは2026年8月10日から適用です。無料プランは枠を超えても請求されませんが、保存量の上限に達すると、状態を保存しようとしたインスタンスがエラーになります。細かい条件は Workflows の料金ページ で確認してください。

インスタンスが起動してから完了するまでの期間のうち、コードが計算している間だけを CPU 時間に数える。sleep や API の応答待ち、イベント待ちの間は数えない
sleep や API の応答を待つ間は CPU 時間に入らず、計算している間だけが数えられます。

始め方:最初のWorkflowを動かす

公式の Get started は、プロジェクトを作り、Workflow のクラスと設定を足して、手元で試してから公開する流れです。用意するものは Cloudflare のアカウントと Node.js です。

  1. プロジェクトを作る(TypeScript を選ぶ)
  2. src/workflow.ts に Workflow のクラスを書く
  3. wrangler.jsonc に設定を足し、型を作る
  4. src/index.ts の fetch ハンドラーで env.MY_WORKFLOW.create() を呼ぶ
  5. 手元で動かして、起動を試す
  6. 公開する
  7. 各ステップの結果を見る
npm create cloudflare@latest -- my-workflow   # 1. プロジェクトを作る
npx wrangler types                            # 3. 型を作る
npx wrangler dev                              # 5. 手元で動かす
curl http://localhost:8787                    # 5. 起動を試す
npx wrangler deploy                           # 6. 公開する
npx wrangler workflows instances describe my-workflow latest   # 7. 結果を見る

設定には name・binding・class_name を書きます。class_name は書き出したクラス名と同じにします。 binding はコードから使う名前になります。

{
  "workflows": [
    { "name": "my-workflow", "binding": "MY_WORKFLOW", "class_name": "MyWorkflow" }
  ]
}

完成形から始めるなら、公式のテンプレートも使えます。

npm create cloudflare@latest workflows-starter -- --template "cloudflare/workflows-starter"

使う前の注意点:手順の分け方

ステップは再試行されることがあるため、公式は書き方の決まり(Rules of Workflows)を示しています。

  • ステップは冪等(何度実行しても結果が同じになること)にする。例:課金の前に課金済みかを確かめる
  • 外部 API やデータベースの呼び出しごとにステップを分ける
  • ステップの外に状態や副作用を置かない
  • ステップ名に日時や乱数を使わない
  • 戻り値は1MiBまで。大きなデータは R2 などに置く
  • タイムアウトは30分以下にし、長く待つなら step.waitForEvent を使う

区切りに迷ったら、公式の勧めどおり「一部が失敗したら、全部やり直したいか」と考えます。

インスタンス ID と自社のユーザー ID の対応は、D1 などのデータベースに保存するよう公式は勧めています(Cloudflare D1 の解説記事)。

2026年11月時点の公式ページの主な上限は次のとおりです。なお、Workers for Platforms では使えません。

項目無料プラン有料プラン
CPU 時間10ミリ秒既定30秒、最大5分
1つの Workflow のステップ数1,024既定1万、最大2万5,000
同時に動くインスタンス(アカウントあたり)1005万
1インスタンスの状態100MB1GB

よくある質問

途中で止めたり、やり直したりできますか?

できます。一時停止・再開・停止・やり直しができ、状態は status() で確かめられます。停止したインスタンスは再開できません。

実行の記録はいつまで残りますか?

2026年11月時点の公式ページでは、完了・エラーの状態とログは無料プランで3日、有料プランで既定7日・最長30日です。2026年9月10日より前に有料プランで作った Workflow は、既定30日のままです。

Pythonでも書けますか?

書けます。Python Workflows SDK が、2025年8月にオープンベータとして公開されました。ダッシュボードの Workflow の図(ベータ版)は、公式ページでは Python を対象外としています。

Pagesのサイトから呼び出せますか?

Workflow を入れた Worker を別にデプロイし、サービスバインディングか fetch で呼べます。公式は、Pages より Workers の Static Assets を使う構成を勧めています。

AIエージェントの処理にも使えますか?

使えます。公式には、LLM の呼び出しとツールの呼び出しをそれぞれステップにするチュートリアルがあります。途中で落ちても、最後に成功したステップから再開します。

この記事のポイント

  • Workflowsは手順ごとに結果を保存し、失敗した手順から再開する
  • 待つ・やり直す・取り消すを、キューやcronを組まずに書ける
  • 料金はCPU時間・起動回数・保存量・ステップ数の4つで数える
  • 1件ずつ届けるならQueues、手順を進めるならWorkflows

まとめ

Cloudflare Workflows は、ステップごとに結果を保存し、失敗した手順だけを自動でやり直しながら、複数の手順を進める仕組みです。最長365日待てて、Webhook や人の承認も待てます。1件ずつ届けるなら Queues、手順を進めるなら Workflows と使い分けます。

料金は4つの項目で数え、無料プランにも1日3,000ステップなどの枠があります。まずは公式のテンプレートか Get started どおりに作り、wrangler dev で手元で動かし、ステップの結果を確かめてみてください。

無料ダウンロード資料「Cloudflareが漫画でわかる」資料を受け取る

この記事を書いた人

フレアはゆる

編集長

フレアはゆるフレア ハユル

Cloudflare を知り尽くした(未来形)、フレアはゆるの編集長。Webサイト制作とサーバー運用の現場で Cloudflare を使い、迷ったところ・つまずいたところをそのまま記事にしています。

フレアはゆるについて詳しく見る →

サーバーの記事一覧へ戻る
フレアはゆるとははゆるに相談