Show HN: DBOSify – Postgres上に構築されたドロップイン可能なTemporal代替
Show HN: DBOSify – Drop-in Temporal replacement built on Postgres (github.com)
要約
DBOSifyは、Temporalサーバーの代わりにPostgresを使用するTemporal Pythonのドロップイン代替ライブラリです。これにより、Postgres以外のインフラを必要とせずに、耐久性のあるワークフロー、アクティビティ、シグナル、更新、リトライ、リカバリを実行できます。本ライブラリは、既存のTemporal Pythonアプリケーションに簡単に統合でき、主要なTemporal機能の互換性と信頼性を維持しつつ、シンプルなPostgresベースのバックエンドを提供します。
全文翻訳
DBOSify
DBOSifyは、Temporal Pythonのドロップイン代替ライブラリで、Temporalサーバーの代わりにPostgres(DBOS Transact経由)を使用します。これにより、Postgres以外のインフラストラクチャを必要とせずに、耐久性のあるワークフロー、アクティビティ、シグナル、更新、リトライ、リカバリを実行できます。
[画像: DBOSifyアーキテクチャ: DBOSifyクライアントとDBOSifyワーカーがPostgresを介して連携し、Postgresがワークフローのオーケストレーションを処理します]
このライブラリを使用するには、temporalioの代わりにdbosifyをインポートし、ワーカーとクライアントをPostgresデータベースに接続します。
[画像: DBOSifyはTemporal Pythonのドロップイン代替です]
使用方法
インストールするには:
pip install dbosify
これはドロップイン代替です。temporalioの代わりにdbosifyをインポートし、クライアントとワーカーをTemporalサーバーの代わりにPostgresデータベースに接続するだけです。詳細なドキュメントはこちらにあります。
import asyncio
import os
from datetime import timedelta
from dbosify import activity, workflow
from dbosify.client import Client
from dbosify.worker import Worker
# Postgresデータベースへの接続文字列を設定してください
DB_URL = os.environ.get("DBOS_SYSTEM_DATABASE_URL")
@activity.defn
async def compose_greeting(name: str) -> str:
return f"Hello, {name}!"
@workflow.defn
class GreetingWorkflow:
@workflow.run
async def run(self, name: str) -> str:
return await workflow.execute_activity(
compose_greeting, name, start_to_close_timeout=timedelta(seconds=10)
)
async def main() -> None:
worker = Worker(
DB_URL,
task_queue="greetings",
workflows=[GreetingWorkflow],
activities=[compose_greeting],
)
async with worker:
async with await Client.connect(DB_URL) as client:
result = await client.execute_workflow(
GreetingWorkflow.run, "World", id="greeting-1", task_queue="greetings"
)
print(result) # Hello, World!
if __name__ == "__main__":
asyncio.run(main())
仕組み
DBOSifyは、各TemporalワークフローをPostgresベースのDBOSワークフローとして実行します。決定論的なインタープリターが、イベントが到着したときにのみ進む仮想イベントループ上でワークフロー(メインコルーチンおよびシグナル、更新、クエリハンドラの両方)を実行します。DBOSステップとワークフロー通信プリミティブを使用することで、すべての非決定論的なアクションは、ワークフローがそれらを観測する前にPostgresにチェックポイントされます。
- アクティビティとタイマーは、DBOSステップと耐久性のあるスリープになり、それぞれが完了時にチェックポイントされます。
- シグナル、更新、キャンセルは、PostgresのLISTEN/NOTIFYを使用して配信される耐久性のあるメッセージです。
- リカバリは、新しいワーカーでワークフローを再実行します。インタープリターは、記録されたチェックポイントに対して同じ一連の操作を再生するため、実行は中断したところから再開され、正確に一度完了します。
- 名前空間はそれぞれ独自のPostgresスキーマにマッピングされます。
ClientはDBOSクライアントをラップし、WorkerはDBOSランタイムをラップします。
テスト方法
DBOSifyはTemporalのドロップイン代替であるため、そのテストはTemporalとの正確性と適合性の両方を以下の戦略でカバーしています。
- 関連するTemporal Pythonの単体テストおよび統合テストのポート
- 関連するTemporal Pythonサンプルアプリケーションのポート。DBOSifyがドロップイン代替であることを検証します。
- 新しい単体テストおよび統合テスト。特に、決定論的な障害リカバリを検証するキル&リカバリテストに重点を置いています。
- これらのライブラリの公開APIが同一であることを機械的にアサートするシグネチャパリティテスト(文書化された例外を除く)。
これは何かではありません
- ワイヤプロトコル互換性はありません。 gRPCワイヤ互換性はありません。他の言語のTemporal SDKは接続できません。これは、Python専用アプリケーションのTemporalサーバーとPython SDKを完全に置き換えるものです。
- Temporal Web UI、
temporalCLI、またはtctlはありません。 DBOSのワークフロー管理APIとDBOS Conductorを使用します。
アーキテクチャの違いや機能互換性については、こちらのドキュメントを参照してください。