What is the job's state machine

[chenyanchen]

What is the state of jobs?

I try to visualize the state of jobs in a state diagram, but I am not sure if it is correct.

And some questions:

• How pending is changed to scheduled?
• Is scheduled --> available correct? If correct, how scheduled is change to available?

Loading

stateDiagram-v2
  [*] --> pending
  pending --> scheduled
  scheduled --> available
  available --> running

  retryable --> scheduled

  pending --> cancelled: cancel
  scheduled --> cancelled: cancel
  available --> cancelled: cancel
  running --> cancelled: cancel

  running --> retryable
  running --> completed
  running --> discarded

  cancelled --> [*]
  completed --> [*]
  discarded --> [*]

[bgentry]

The states are documented in the Go code: https://pkg.go.dev/github.com/riverqueue/river/rivertype#JobState

• Jobs in pending will never be worked or deleted unless moved out of this state by the user. River Pro does this for some use cases or you can write your own code for it if you have a specific use case. Most users won’t utilize this state themselves—it’s an advanced feature.
• The job scheduler moves jobs to available as their scheduled time approaches.

[chenyanchen]

Thanks for your answer. But if there have a diagram, things will be more clearly.