Welcome to the (state) machine - Demos

A tickets booking system - based on SOA principles.

This demo aims to demonstrate how to use sagas to overcome the architectural limitations of Process Managers in distributed systems. This is the support demo of my Welcome to the (state) machine talk.

The demo assumes some knowledge of what service boundaries are and what the role of ViewModel Composition is in SOA based systems. I recommend watching the following 2 talks to find out more about figuring out service boundaries, and how to deal with UI/ViewModel aspects in a microservices/SOA system without reintroducing coupling by doing request/response between the services.

• Finding your service boundaries - a practical guide by @adamralph
• All Our Aggregates Are Wrong by @mauroservienti (myself)

An exhaustive dissertation about ViewModel Composition is available on my blog in the ViewModel Composition series.

Requirements

The following requirements must be met in order to successfully run the demos:

• Visual Studio Code and the Dev containers extension.
• Docker must be pre-installed on the machine.
• The repository devcontainer setup requires docker-compose to be installed on the machine.

How to configure Visual Studio Code to run the demos

• Clone the repository
  • On Windows make sure to clone on short path, e.g. c:\dev, to avoid any "path too long" error
• Open one of the demos folder in Visual Studio Code
• Make sure Docker is running
  • If you're using Docker for Windows with Hyper-V make sure that the cloned folder, or a parent folder, is mapped in Docker
• Open the Visual Studio Code command palette (F1 on all supported operating systems, for more information on VS Code keyboard shortcuts refer to this page)
• Type Reopen in Container, the command palette supports auto-completion, the command should be available by typing reop

Wait for Visual Studio Code Dev containers extension to:

• download the required container images
• configure the docker environment
• configure the remote Visual Studio Code instance with the required extensions

Note: no changes will be made to your Visual Studio Code installation, all changes will be applied to the VS Code instance running in the remote container

The repository devcontainer configuration will:

• One or more container instances:
  • One RabbitMQ instance with management plugin support
  • One .NET enabled container where the repository source code will be mapped
  • A few PostgreSQL instances
• Configure the VS Code remote instance with:
  • The C# extension (ms-dotnettools.csharp)
  • The PostgreSQL Explorer extension (ckolkman.vscode-postgres)

Once configuration is completed VS Code will show a new Ports tab, in the bottom-docked terminal area. The Ports tab will list all the ports exposed by the remote containers.

Containers connection information

The default RabbitMQ credentials are:

• Username: guest
• Password: guest

The deafult PostgreSQL credentials are:

• User: db_user
• Password: P@ssw0rd

How to run the demos

To execute the demo open the root folder in VS Code, press F1 and search for Reopen in container. Wait for the Dev Container to complete the setup process.

Once the demo content has been reopened in the dev container:

1. Press F1, search for Run task, and execute the desired task to build the solution or to build the solution and deploy the required data
2. Go to the Run and Debug VS Code section to select the desired compund to execute.

Disclaimer

This demo is built using NServiceBus Sagas, I work for Particular Software, the makers of NServiceBus.