Assembly Replay とは何ですか?
Transloadit の Assembly Replay は、入力を復元できる場合に、以前の Assembly の保存済み Instructions から新しい Assembly を開始します。この際、元のファイルを再度アップロードする必要も、Instructions が Template に由来する必要もありません。Assembly Replay は手動で開始できます。スケジュールされていない Assembly が ASSEMBLY_CRASHED ステータスの場合、その Workspace で該当オプションが有効になっていれば、自動的に再実行されます。
Assembly Replay の仕組み
リプレイは、過去の実行を基に新たな処理を試みます。元の Assembly とともに保存された処理設定を再利用するため、Template は不要です。ただし、Template に基づく Assembly では、リプレイ時に Template を再解決できます。入力は再転送ではなく復元されます。Transloadit は、約 24 時間保持されるアップロードの内部一時コピーを優先的に使用し、それがなければ保存済み URL から各アップロードをインポートします。一方、ファイルをインポートまたは生成する Step は、入力を再作成します。自動リプレイは、有効になっている Workspace でクラッシュした実行に対応し、手動リプレイでは運用担当者が明示的に再試行を制御できます。新しい実行は元の実行とは別のもので、そのステータスには親へのリンクが含まれます。
要点
- リプレイの可否は、Template の有無や固定の期限ではなく、入力を復元できるかどうかで決まります。復元可能なアップロードファイルもインポート用 Step もない Assembly は、
ASSEMBLY_CANNOT_BE_REPLAYEDで拒否されます。約 24 時間という保持期間は、Transloadit のアップロードの内部一時コピーに適用されるもので、リプレイが不可能になる厳密な期限ではありません。 - リプレイされた処理は、独自の識別子を持つ新しい Assembly です。そのステータスは
parent_assembly_statusを通じて元の Assembly を参照します。リプレイリクエストでは、異なるnotify_urlを指定したり、Step を上書きしたりできます。 - 外部の入力や送信先は試行の間に変わることがあります。そのため、Step が変更可能なリモートの状態を読み取ったり、冪等でない対象に書き込んだりする場合、リプレイの結果は非決定的になります。
Assembly Replay が重要になる場面
処理に失敗しても元のファイルを再アップロードするのが無駄になる場合は、条件を満たす Assembly をリプレイしてください。すべての入力が引き続き復元可能であり、処理設定が現在の外部の状態にも適合していることを確認し、リプレイを親に関連付けられた新しい Assembly として追跡してください。