Please ensure you have prepared your machine well in advance of the workshop. Your time during the workshop is valuable, and we want to use it for learning, rather than setting up machines.
If you have any difficulty preparing your machine, or following this document, please raise an issue in this repository ASAP so that we can resolve the problem before the workshop begins.
To complete the exercises, you require a Windows machine and Visual Studio.
Install JetBrains Rider 2021.3 or later, or Visual Studio 2022 or later (Community, Professional, or Enterprise) with the following workloads:
- .NET desktop development
- ASP.NET and web development
The following frameworks need to be installed:
- .NET 8
The Particular Service Platform includes ServiceControl, ServicePulse and ServiceInsight. The samples include a platform connection package that will fire up both ServiceControl and ServicePulse, without requiring any installation.
In order to try out ServiceInsight, an installation is required. The latest version can be downloaded from GitHub. Once installed, ServiceInsight needs to be connected to ServiceControl. To do so, click the "Connect" button at the top left of the screen, and enter the ServiceControl URL. You can find the correct URL in ServicePulse, which shows a status bar with the ServiceControl information. Hovering over that, will expose the ServiceControl API URL.
Clone or download this repo. If you're downloading a zip copy of the repo, ensure the zip file is unblocked before decompressing it:
- Right-click on the downloaded copy
- Click "Properties"
- On the "General" properties page, check the "Unblock" checkbox
- Click "OK"
The exercises are contained in Visual Studio solutions under exercises. All the solutions require NuGet package restore. This may be possible at the workshop venue (you can verify with the workshop organizers if internet access is available at the venue) but to ensure you can build the solutions during the workshop, we recommend you restore all NuGet packages and build all the solutions before the workshop starts. The simplest way to do this is to open a command prompt, navigate to your copy of this repo, and run .\build.cmd exercises. (For a full list of build targets, run .\build.cmd -T, or .\build.cmd -h for help.) You can safely ignore any compiler warnings.
Before opening any exercise solutions, set the startup projects by navigating to your copy of this repo and running set-startup-projects.cmd. Note that if you git clean your clone, you will have to run this command again.
The startup projects are also listed in the instructions for each exercise. If you need to, you can configure them manually:
- In Visual Studio, right click the solution in the Solution Explorer
- Click "Properties"
- Ensure that, in the left hand pane, "Common Properties", "Start Project" is selected.
- Select the "Multiple startup projects" radio button
- Set the "Action" for each project listed in the instructions for the exercise to "Start".
To run an exercise solution, simply press F5 in Visual Studio. The exercise solution will now be running and fully functional.
If you are getting access denied exceptions on the file system while running the exercises the cause is likely virusscanners, backup or file synchronisation software like dropbox or onedrive opening these files. Exclude the .learningtransport folder or temporarily disable these tools.
The self contained platform demo includes ServicePulse, ServiceControl, ServiceControl Monitoring and a few endpoints to demonstrate monitoring and recovery.
If the answer to your question is not listed here, consult your on-site trainer.