Edge Forms

English

日本語

English

日本語

Appearance

Japanese source

The original specification and guide are authored in Japanese. The Japanese route contains the same source text; this English route is a reading aid, not a separate translation or an implementation-availability claim.

Edge Formsを使う ​

Edge Formsは、Workerアプリケーション、データ保存、イベント処理に使う資源の仕様です。 たとえばWorkerのコードを更新する場合、コードの集合を作り、そのコードと設定を一つの版にまとめ、 トラフィックの行き先を切り替えます。それぞれの資源が何を受け取り、何を変更するかをFormで定めます。

このサイトはtako0614が定義するFormを掲載します。他の作者のFormやProviderと組み合わせて使えます。 共通の通信方法はTakoform Host API v2、 各資源の意味は以下の個別仕様、実行先と提供条件は利用するHostが定めます。

目的から選ぶ ​

  • Workerのアプリケーションを作る — ModuleWorkerがアプリの識別と実行モデルを定めます。
  • コードを登録する — WorkerBundleに、検証できるコードとファイルの組を渡します。
  • 静的ファイルを使う — StaticAssetBundleをWorkerVersionへ接続します。
  • コードと設定を固定する — WorkerVersionがbundle、ハンドラー、環境変数、資源への接続をまとめます。
  • 稼働する版を切り替える — WorkerDeploymentがWorkerVersionへのトラフィック配分を選びます。
  • HTTPSで公開する — Hostが割り当てるWorkerEndpoint、または所有する名前のWorkerCustomDomainを使います。
  • key/valueを保存する — EdgeKVNamespaceは結果整合のバイト列ストアです。即時に同じ値が読める保証とは異なります。
  • ファイルを保存する — ObjectBucketはストリーミングとmultipart操作を持つオブジェクトストアです。
  • SQLでデータを扱う — SQLiteDatabaseがデータベース、SQLiteMigrationSetが変更履歴、SQLiteMigrationApplicationがその適用です。
  • 非同期にメッセージを処理する — AtLeastOnceQueueへ送り、QueueConsumerでWorkerへ届けます。重複配信を前提にします。
  • 定期処理を実行する — WorkerCronTriggerがUTCのスケジュールでWorkerを呼び出します。
  • IDごとの状態を持つ処理を動かす — ActorNamespaceがActorのID空間と実行を定めます。
  • 中断から続行する処理を動かす — DurableWorkflowがステップの保存、再実行、完了結果を定めます。

Queue、Actor、Workflowの違い ​

Queueは処理したいメッセージを配送します。Actorは同じIDへの呼び出しと状態を扱います。 Workflowは一つの実行の進み具合を保存し、中断後に続けます。どれか一つが他の代替になるわけではありません。 アプリの必要な性質に合わせて選び、配信の重複や外部への副作用も各仕様に沿って扱います。

最初に読むもの ​

  1. Hostで資源を作るで、Formの選択から作成・更新・削除までの流れを確認します。
  2. 個別Formの入力、出力、削除範囲を読みます。入力例のUIDやartifact URLは説明用です。
  3. Terraform/OpenTofuで使うで、Providerが対応する版とHCLの所有範囲を確認します。
  4. 既存v1の資源がある場合だけ、移行と既存資料を読みます。

仕様と利用できる状態 ​

ここにあるForm本文はHost API v2向けの仕様です。各版の日本語原文は、canonical URLと本文のSHA-256で 同一性を固定しています。本文が固定されていても、そのURLから取得できることやHost・Providerの対応は示しません。 利用前に公開ページで正確なForm URLと仕様を確認し、Hostのsupportで同じURLへの対応を確かめてください。 Offeringがある場合は容量・料金・制限も確認します。

ContainerやVectorIndexの既存提案は、この17種類に含めていません。別の検討を、URLや実装が存在するだけで 利用できるFormとして紹介しません。各Formの版は独立しており、この一覧全体のリリース版はありません。