Skip to main content
When a workflow job fails because of a bug in task code, you can often fix the code, publish a compatible release, deploy it to the same cluster, and retry the failed job. Tilebox resumes from failed tasks instead of rerunning completed work.

Confirm the fix is compatible

A retry can use the fixed release when the failed task and the new task registration are compatible. Keep these stable:
  • task identifier name
  • task major version
  • task input schema
Use a new major task version and submit a new job when the input schema or behavior is no longer compatible with the failed task.

Publish the fixed release

After editing the workflow code, publish a new release.
For validation details, build locally first.

Deploy to the same cluster

Deploy the fixed release to the same cluster that received the original job.
The job cluster, release deployment cluster, and release runner cluster must match.

Retry the job

Retry the failed job.
Then inspect logs and spans to confirm the fixed task completed.

Next steps

Workflow releases

Understand release compatibility and task registrations.

Debug a failed workflow run

Inspect task state, logs, traces, and runner context.