Skip to main content

Developer Lifecycle

Eventual is designed to provide a light-weight and fast developer lifecycle. In general, the process looks like as follows:

  1. Build - start writing code, create Commands, Workflows, Tasks, etc.
  2. Run - start a server running the service locally for instant feedback
  3. Test - write unit tests and mock out parts of your service
  4. Deploy - deploy the service to production
  5. Replay - debug broken workflows by replaying them locally in your IDE
  6. ... repeat

Build​

Start writing code. Add Commands, Workflows, Tasks, Subscriptions, configure Infrastructure, etc.

Run​

Run your Service locally to test it as a whole. Follow a tracer-bullet feature end-to-end. Observe how they interact with each other. Set breakpoints and follow execution across all of these pieces.

info

See How to run locally for more information.

Test​

Add unit tests for individual pieces. Mock out different parts of your application to test in isolation.

info

See How to unit test for more information.

Deploy​

Once you're ready, you can deploy to AWS from the root, for example from within your CI/CD.

npm run deploy

Replay​

When a workflow breaks in production, use the eventual reply CLI to download and replay a workflow locally to debug in your IDE.

info

See How to debug production workflows for more information.