Distributed Scheduler API building block docs

[hhunter-ms]

Work involved

Jobs pt 1 PR

merged #4164

• Overview for Jobs API
• Add to conceptual overview
• Add to building blocks concepts
• Update preview feature doc
• Update list of Alpha APIs
• Add API reference doc
• Diagrams
• Update dapr init doc to include Scheduler service as included

Jobs pt 2 PR

merged #4240

• Jobs API how-to - minor add from README in Go-SDK example PR
• Check formatting and grammar (ie: Jobs overview)

Jobs pt 3 PR

in progress #4243

• Screenshot of dapr init and docker ps output that shows scheduler service is running
• Finish how-to based on future quickstart or example
• Add how to consume a triggered job

The associated pull request from dapr/dapr, dapr/components-contrib, or other Dapr code repos
dapr/proposals#44

[cicoyle]

Note for myself: the Scheduler will also need to be documented here since its a new control plane service as well.

[cicoyle]

This is an involved update and requires updating several documents and diagrams

Let's just call this the Scheduler API, rather than Distributed Scheduler API. All of the APIs are distributed in some way and this term is redundant.

• Overview https://docs.dapr.io/concepts/overview/ This includes updating the diagrams for the control plane for K8s and for VMs @hhunter-ms -
• Control plane services https://docs.dapr.io/concepts/dapr-services/ to add new scheduler service @cicoyle
• New Scheduler API https://docs.dapr.io/concepts/building-blocks-concept/ @hhunter-ms
• Add developing with Scheduler API https://docs.dapr.io/developing-applications/building-blocks/ @cicoyle
• Add Scheduler overview https://docs.dapr.io/developing-applications/building-blocks/scheduler/scheduler-overview/
• Add Scheduler HowTo: https://docs.dapr.io/developing-applications/building-blocks/scheduler/howto-scheduler/ including examples from SDKs. If all examples not created then raising issues in each SDK
• Update the preview feature if needed https://docs.dapr.io/operations/support/support-preview-features/ @ scheduler reminder preview feature config: SchedulerReminders @cicoyle
• Update the list of Alpha APIs https://docs.dapr.io/operations/support/alpha-beta-apis/ @hhunter-ms
• Add Scheduler API into reference https://docs.dapr.io/reference/api/ including all the APIs with examples @cicoyle
• Update Dapr presentation deck https://docs.dapr.io/contributing/presentations/ @marcduiker
• Update Diagram deck @hhunter-ms
• Update go-sdk docs with samples https://docs.dapr.io/developing-applications/sdks/go/go-client/ @cicoyle

[msfussell]

Also see this issue in QS repor - Go SDK Quickstart for Scheduler API dapr/quickstarts#1026

[cicoyle]

Adding a TODO here, so I don't forget- thx @olitomlinson for calling this out in discord:

The dapr docs for the new Job API do not demonstrate how to consume a triggered job in an App - the OnJobEvent bits. We should add this

[hhunter-ms]

thanks for your help, @cicoyle !!