All our Aggregates are Wrong - Demos
A microservices powered e-commerce shopping cart sample - based on SOA principles.
How to get the sample working locally
Get a copy of this repository
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:
- Right-click on the downloaded copy
- Choose Property
- On the Property page tick the unblock checkbox
- Press OK
Check your machine is correctly configured
In order to run the sample the following machine configuration is required:
- PowerShell execution policy to allow script execution, from an elevated PowerShell run the following:
A SQL Server edition or the
LocalDbinstance installed by Visual Studio, in case of a clean machine with
LocalDbonly please install:
- Microsoft ODBC Driver 11 for SQL Server, available for download at https://www.microsoft.com/en-us/download/details.aspx?id=36434
- Microsoft ODBC Command Line Utilities 11 for SQL Server, available for download at https://www.microsoft.com/en-us/download/details.aspx?id=36433
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)\(localdb)\microservices-done-right database using, for example, Visual Studio or SQL Managerment Studio, and running the SQL contained in the
.sql file (
Teardown-Databases.sql) corresponding to the
.ps1 file which raised the error.
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.
Ensure the following projects are set as startup projects:
This sample has no NServiceBus related pre-requisites as it's configured to use the new Learning Transport and Learning Persistence 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.