For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/modules/jobs.md (or send Accept: text/markdown).

Trigger.dev ジョブ

耐久性のあるワークフロー動作を明示的に保つ。

このガイドについて質問

インストールとセットアップ

手順の前に、始める前にとターミナルの基本をお読みください。これらの手順では、VS Code で完全な supastack モノリポジトリを開いたことが前提となっています。そのルート package.json はリポジトリのルートをマークします。 pnpm コマンドでは、ワークスペースパッケージはアプリまたは共有コードフォルダーです。この製品では、ワークスペースはチームのデータコンテナであり、セキュリティ境界です。 corepack pnpm --filter ... コマンドがルートから実行されている間にモノリポジトリから 1 つのパッケージを選択します。同期されたモバイルフォルダーまたはデスクトップフォルダーのみを開いた場合、そのフォルダーには Web バックエンド、Docker セットアップ、またはルートスクリプトが含まれていません。このモノリポジトリまたはアクセス可能なホストサーバーからバックエンドを実行し、プラットフォームフォルダー独自のスクリプトを使用します。環境変数は、ローカルの .env ファイルまたはホスティングダッシュボードに保存される名前付き設定です。変更後に関連するアプリを再起動し、NEXT_PUBLIC_ および EXPO_PUBLIC_ 値にサーバーシークレットが含まれないようにします。

1. VS Code で apps/web/src/job-handlers.ts および apps/web/src/scheduler-runtime.ts を開きます。ジョブはバックグラウンド作業です。スケジューラはそれをいつエンキューするかを決定します。

2. ローカルティックの場合、apps/web/.env.local とリポジトリルート .env に同じ SCHEDULER_TICK_SECRET を設定します。ティックスクリプトはルート .env を読み取り、Web エンドポイントはアプリ設定を読み取ります。

3. corepack pnpm --filter @supastack/web dev を使用して Web を起動し、次に corepack pnpm jobs:tick をルートから実行します。予想通り: 端末には、localhost:3000 からの POST 結果が表示されます。 Trigger.dev は別個のプロバイダーであり、独自のアカウントとサーバーキーが必要です。

本番タスク送信には JOB_PROVIDER=trigger とサーバー専用の TRIGGER_SECRET_KEY・TRIGGER_PROJECT_REF を設定します。ターゲットプロジェクトを設定する前に apps/web/trigger.config.ts と apps/web/trigger の ai.generate タスクを確認してください。

JOB_PROVIDER=trigger
TRIGGER_PROJECT_REF=your-project-reference
# Provide TRIGGER_SECRET_KEY through the server secret store.

コピーするコマンド

コメントに従って、コマンドがどのフォルダーで実行されるかを確認します。 2 つのターミナルにラベルが付いている場合は、2 つのターミナルウィンドウを開き、2 番目のコマンドを使用している間、最初のコマンドを実行し続けます。

# Terminal 1 — start the Web app from the monorepo root:
corepack pnpm --filter @supastack/web dev

# Terminal 2 — run one scheduler tick from the monorepo root:
corepack pnpm jobs:tick

実装ワークフロー

共有 JobRunner コントラクトは enqueue・status・cancel を約束します。ワークフロー固有の意味論は Trigger.dev に属します。汎用インターフェースからスケジューリング、リトライ、耐久性保証を推測しないでください。

アプリケーションの耐久タスク ID はディスパッチ、ワーカー実行、使用量レコード、結果を結びつけます。確認済み enqueue 後にプロバイダー実行メタデータの添付に失敗しても、別の enqueue を引き起こしたり受け入れられた作業を無効にしたりすべきではありません。

検証とトラブルシューティング

チェックマークが 404 を返した場合は、シークレットが両方の設定ファイルに存在し、正確に一致することを確認してから、Web を再起動します。端末に接続が拒否されたと表示された場合は、まず Web を起動してください。ジョブが実行されなかった場合は、スケジュールが有効になっていて期限があることを確認してください。 1 つのチェックマークを付けても、将来のスケジュールがすぐに実行されるわけではありません。

デプロイ済みタスク識別子とプロジェクトが設定済み環境と一致することを検証します。enqueue 受け入れをワークフロー完了とメール配信から分けます。作業を手動で再試行前に、安全な復旧と診断について docs/production-ai-runtime.md を読んでください。