studio/flamenco
studio/flamenco
12
30
Fork 38
Code Issues 64 Pull Requests 5 Releases Wiki Activity

Website: Documenting descriptions for Job and Task Statuses in the documentation webpage. #104214

Merged
Sybren A. Stüvel merged 5 commits from Adi.Sage/flamenco:updating-job-and-task-statuses into main 2023-06-22 19:41:53 +02:00
Conversation 1 Commits 5 Files Changed 1 +11 -11
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 9fb44b4f89 - Show all commits

22
web/project-website/content/usage/jobs-tasks-commands/_index.md
View File

@ -12,14 +12,14 @@ The following table shows the meaning of the different job statuses:
| Status | Meaning | Possible next status | | Status | Meaning | Possible next status |
| ------------------------- | ------- | ----------- | | ------------------------- | ------- | ----------- |
| `under-construction` | Preparing job for execution | `queued`, `active` | | `under-construction` | Preparing job for execution | `queued`, `active` |
| `queued` | Ready to be assigned to an available workers | `active`, `canceled` | | `queued` | Ready to be assigned to available Workers | `active`, `canceled` |
| `active` | Tasks assigned to workers for execution | `completed`, `canceled`, `failed` | | `active` | Tasks assigned to Workers for execution | `completed`, `canceled`, `failed` |
| `completed` | All tasks executed successfully | `requeued` | | `completed` | All tasks executed successfully | `requeued` |
| `failed` | Execution of one or more tasks failed after multiple retries by different workers | `???`, `???` | | `failed` | Execution of one or more tasks failed after multiple retries by different Workers | `???`, `???` |
| `cancel-requested` | Request for job cancellation raised by user | `canceled` | | `cancel-requested` | Request for job cancellation raised by user | `canceled` |
| `canceled` | Canceled by the user, job terminated immediately on all workers | `requeued` | | `canceled` | Canceled by the user, job terminated immediately on all Workers | `requeued` |
| `requeueing` | Request for requeueing of job raised by user | `???`, `???` | | `requeueing` | Request for requeueing of job raised by user | `queued` |
| `archiving` | Archiving job details | `???`, `???` | | `archiving` | Archiving job details | `archived` |
| `archived` | Job details archived in history for future reference | `???`, `???` | | `archived` | Job details archived in history for future reference | `???`, `???` |
Sybren A. Stüvel commented 2023-05-24 10:51:14 +02:00
Outdated
Review
Copy Link

As discussed on Blender Chat, the archiving and archived statuses don't have to be added to the docs, as they are left-overs from Flamenco v2 and are not used any more.

As discussed on Blender Chat, the `archiving` and `archived` statuses don't have to be added to the docs, as they are left-overs from Flamenco v2 and are not used any more.
| `paused` | Not yet implemented | | | `paused` | Not yet implemented | |
@ -30,9 +30,9 @@ The following table shows the meaning of the different task statuses:
| Status | Meaning | Possible next status | | Status | Meaning | Possible next status |
| ------------- | ------- | ----------- | | ------------- | ------- | ----------- |
| `queued` | Ready to be assigned to an available Worker | `active`, `canceled` | | `queued` | Ready to be assigned to an available Worker | `active`, `canceled` |
| `active` | Assigned to a worker for execution | `completed`, `canceled`, `failed`, `soft-failed` | | `active` | Assigned to a Worker for execution | `completed`, `canceled`, `failed`, `soft-failed` |
| `completed`   | Worker executed the task succesfully | `requeued` | | `completed`   | Task executed succesfully | `queued` |
| `soft-failed` | Same as `queued`, but has been failed by a worker in an earlier execution | `completed`, `failed`, `canceled` | | `soft-failed` | Same as `queued`, but has been failed by a Worker in an earlier execution | `completed`, `failed`, `canceled` |
Sybren A. Stüvel commented 2023-05-24 10:50:16 +02:00
Review
Copy Link

Another possible next status would be queued, as you can re-queue a job that has a mixture of task statuses, and after requeueing those should all go to either queued or remain at completed.

FYI: requeuing a job that's completed will requeue all its tasks. When that the job was not 100% complete yet, it will only requeue the not-yet-completed tasks, and leave the completed ones alone.

Another possible next status would be `queued`, as you can re-queue a job that has a mixture of task statuses, and after requeueing those should all go to either `queued` or remain at `completed`. FYI: requeuing a job that's `completed` will requeue all its tasks. When that the job was not 100% complete yet, it will only requeue the not-yet-completed tasks, and leave the completed ones alone.
Adi.Sage commented 2023-05-25 17:26:56 +02:00
Review
Copy Link

Noted 👍 I will remove the archive and archived as requested.

Can you elaborate on the following from your second comment :

  • Should I add 'queued' as a possible next status to all the status you have marked out?
  • And the 'FYI' part is just for me or should I add that as a description of 'completed' / 'active'?
Noted 👍 I will remove the `archive `and `archived` as requested. Can you elaborate on the following from your second comment : - Should I add 'queued' as a possible next status to all the status you have marked out? - And the 'FYI' part is just for me or should I add that as a description of 'completed' / 'active'?
Sybren A. Stüvel commented 2023-05-26 11:15:30 +02:00
Review
Copy Link

Should I add 'queued' as a possible next status to all the status you have marked out?

It's not so clear here what I was referring to (compared to the old Phabricator-based review tool we used), my remark was purely about the soft-failed status.

And the 'FYI' part is just for me
It was intended just for you, but to be fair I do think it's a good idea if this makes it into the documentation somehow. Not sure if it looks good when added to this table, or whether it's better to write it down below that. I'll leave that choice to you. Also it could just be another PR later, if you want. Whatever is easiest for you.

> Should I add 'queued' as a possible next status to all the status you have marked out? It's not so clear here what I was referring to (compared to the old Phabricator-based review tool we used), my remark was purely about the `soft-failed` status. > And the 'FYI' part is just for me It was intended just for you, but to be fair I do think it's a good idea if this makes it into the documentation somehow. Not sure if it looks good when added to this table, or whether it's better to write it down below that. I'll leave that choice to you. Also it could just be another PR later, if you want. Whatever is easiest for you.
| `failed` | Execution failed after multiple retries by different workers | `requeued` | | `failed` | Execution failed after multiple retries by different Workers | `queued` |
| `canceled` | Canceled by the user, task terminated immediately | `requeued` | | `canceled` | Canceled by the user, task terminated immediately | `queued` |
| `paused` | Not yet implemented | | | `paused` | Not yet implemented | |