8a5c099d57
This is a comprehensive list of all possible job and task statuses, along with a brief description of each status and a list of possible next statuses. Reviewed-on: https://projects.blender.org/studio/flamenco/pulls/104214
41 lines
2.2 KiB
Markdown
41 lines
2.2 KiB
Markdown
---
|
|
title: Jobs, Tasks, and Commands
|
|
weight: 5
|
|
---
|
|
|
|
TODO: write about the pipeline from job submission to command execution.
|
|
|
|
## Job Statuses
|
|
|
|
The following table shows the meaning of the different job statuses:
|
|
|
|
| Status | Meaning | Possible next status |
|
|
| ------------------------- | ------- | ----------- |
|
|
| `under-construction` | Preparing job for execution | `queued`, `active` |
|
|
| `queued` | Ready to be assigned to available Workers | `active`, `canceled` |
|
|
| `active` | Tasks assigned to Workers for execution | `completed`, `canceled`, `failed` |
|
|
| `completed` | All tasks executed successfully | `queued` |
|
|
| `failed` | Execution of one or more tasks failed after multiple retries by different Workers | `queued`, `canceled` |
|
|
| `cancel-requested` | Request for job cancellation raised by user | `canceled` |
|
|
| `canceled` | Canceled by the user, job terminated immediately on all Workers | `queued` |
|
|
| `requeueing` | Request for requeueing of job raised by user | `queued` |
|
|
| `paused` | Not yet implemented | |
|
|
|
|
NOTE :
|
|
- Requeueing a job when it is `completed`, i.e. when all its tasks are `completed`, will requeue all its tasks.
|
|
- Requeueing a job when some of its tasks are not `completed` will requeue these tasks only. The `completed` tasks will not be requeued, and will remain at `completed` status.
|
|
|
|
## Task Statuses
|
|
|
|
The following table shows the meaning of the different task statuses:
|
|
|
|
| Status | Meaning | Possible next status |
|
|
| ------------- | ------- | ----------- |
|
|
| `queued` | Ready to be assigned to an available Worker | `active`, `canceled` |
|
|
| `active` | Assigned to a Worker for execution | `completed`, `canceled`, `failed`, `soft-failed` |
|
|
| `completed` | Task executed succesfully | `queued` |
|
|
| `soft-failed` | Same as `queued`, but has been failed by a Worker in an earlier execution | `queued`, `completed`, `failed`, `canceled` |
|
|
| `failed` | Execution failed after multiple retries by different Workers | `queued`, `canceled` |
|
|
| `canceled` | Canceled by the user, task terminated immediately | `queued` |
|
|
| `paused` | Not yet implemented | |
|