A microservices powered e-commerce shopping cart sample - based on SOA principles.
Clone or download this repo locally on your machine. If you're downloading a zip copy of the repo please be sure the zip file is unblocked before decompressing it. In order to unblock the zip file:
In order to run the sample the following machine configuration is required:
A SQL Server edition or the
LocalDb instance installed by Visual Studio, in case of a clean machine with
LocalDbonly please install:
NOTE: On a clean machine do not install latest version, as of this writing 13.1, of Microsoft ODBC Driver and Microsoft ODBC Command Line Utilities as the latter is affected by a bug that prevents the
LocalDb instance to be accessible at configuration time.
LocalDB instance setup 2 PowerShell scripts, in the scripts folder, are provided for your convenience. Both need to be run from an elevated PowerShell console.
Setup-Databases.ps1, with elevation, to create the
LocalDBinstance and all the required databases
Teardown-Databases.ps1, with elevation, to drop all the databases and delete the
LocalDB instance is named
NOTE: If you receive errors regarding "Microsoft ODBC Driver", you can work around these by connecting to the
(localdb)\all-our-aggregates-are-wrong database using, for example, Visual Studio or SQL Managerment Studio, and running the SQL contained in the
Setup-Databases.sql file to manually create databases.
NOTE: In case the database setup script fails with a "sqllocaldb command not found" error it is possible to install
LocalDb as a standalone package by downloading it separately at https://www.microsoft.com/en-us/download/details.aspx?id=29062
Solutions is configured to use the SwitchStartupProject Visual Studio Extension to manage startup projects. The extension is not a requirement, it's handy.
The solution can be configured to run 3 different demos.
Demos the default shopping cart behavior and all its implemented functionalities. Add items to the cart, observe the various "services" console windows they'll display log messages related to the ongoing processes. Leave the cart inactive for a few seconds and observe the stale cart policy kicking in, first raising a warning, finally deleting stale carts. Ensure the following projects are set as startup projects:
Demos what happens when a back-end service is not available. Add an item to the cart, visualize the shopping cart and observe the different information displayed in relation to the shipping estimates. Ensure the following projects are set as startup projects:
Uses the Particular Platform Sample package to visualize monitoring information, and messages and policies (Sagas) runtime behaviors.
This sample has no NServiceBus related pre-requisites as it's configured to use Learning Transport and Learning Persistence, both explicitly designed for short term learning and experimentation purposes.
They should also not be used for longer-term development, i.e. the same transport and persistence used in production should be used in development and debug scenarios. Select a production transport and persistence before developing features.
NOTE: Do not use the learning transport or learning persistence to perform any kind of performance analysis.