The examples here showcase the most basic building blocks of Restate: Durable Execution, Durable Promises, Virtual Objects, and the Workflows abstraction built on top of them.
The individual example files contain code snippets with comments and brief descriptions about how they work and how they can be run.
-
Services & Durable Execution: Running code cleanly to the end in the presence of failures. Automatic retries and recovery of previously finished actions. The example creates a subscription to movie streaming services by first creating a recurring payment and then adding the subscriptions.
-
Building blocks: Restate gives you a durable version of common building blocks like queues, promises, RPC, state, and timers. This example shows a reference of the API and what you can do with it.
-
Virtual Objects: Stateful serverless objects to manage durable consistent state and state-manipulating logic.
-
Workflows: Workflows are durable execution tasks that can be submitted and awaited. They have an identity and can be signaled and queried through durable promises. The example is a user-signup flow that takes multiple operations, including verifying the email address.
-
Start Restate Server in a separate shell:
restate-server -
Start the relevant example:
cargo run --example example-0for the Durable Execution example- The building blocks example is not runnable and more like a reference of what you can do with the API
cargo run --example example-2for the Virtual Objects examplecargo run --example example-3for the Workflows example
-
Register the example at Restate server by calling
restate -y deployment register --force localhost:9080.Note: the '--force' flag here is to circumvent all checks related to graceful upgrades, because it is only a playground, not a production setup.
-
Check the comments at the bottom of each example for how to send requests to the example.
NOTE: When you get an error of the type {"code":"not_found","message":"Service 'greeter' not found. ...}, then you forgot step (3) for that example.