README.md

Assignment 1 - Run the application

Assignment goals

In this assignment, you'll run the Traffic Control application to make sure everything works correctly. At this point, you'll be running the microservice application without any Dapr technology. As you work through the lab assignments, you'll add Dapr technology step-by-step.

Step 1. Run the VehicleRegistration service

1. From the file explorer in VS Code, open the src folder.

   Throughout the assignment you'll execute all steps in the same instance of VS Code.

2. Open the terminal window in VS Code.

   You can open it from the Terminal menu item on the top nav menu bar or by using the hotkey Ctrl-Shift-` (Windows) or Shift-Ctrl-` (macOS).

3. In the terminal window, set your current folder to src/VehicleRegistrationService.

4. Start the service by typing in the dotnet run command in the terminal window.

   If you receive an error here, please double-check whether or not you have installed all the prerequisites for the workshop!

Now you can test whether you can call the VehicleRegistrationService. You can do this using a browser, CURL or some other HTTP client. But there is a convenient way of testing RESTful APIs directly from VS Code (using the REST Client extension VS Code):

1. Open the file src/VehicleRegistrationService/test.http in VS Code using the (file) Explorer feature. The request in this file simulates retrieving the vehicle and owner information for a certain license-number.

2. Click on Send request link, located immediately above the GET request in the file and highlighted below in a red box, to send a request to the API:

   

3. The response of the request will be shown in a separate window on the right. It should be a response with HTTP status code 200 OK and the body should contain some random vehicle and owner-information:

   HTTP/1.1 200 OK
   Connection: close
   Date: Mon, 01 Mar 2021 07:15:55 GMT
   Content-Type: application/json; charset=utf-8
   Server: Kestrel
   Transfer-Encoding: chunked
   
   {
       "vehicleId": "KZ-49-VX",
       "brand": "Toyota",
       "model": "Rav 4",
       "ownerName": "Angelena Fairbairn",
       "ownerEmail": "angelena.fairbairn@outlook.com"
   }

4. Check the logging in the terminal window. It should look like this:

   

At this point, the Vehicle Registration microservice is up and running correctly!

Step 2. Run the FineCollection service

1. Make sure the VehicleRegistrationService service is running (result of step 1).

2. Open a new terminal window in VS Code.

   You can do this by using the hotkey (Ctrl-` on Windows, Shift-Ctrl-` on macOS) or clicking on the + button in the terminal window title bar (shown in a red box):

   

3. In the terminal window, make sure the current folder is set to src/FineCollectionService.

4. Start the service using dotnet run in the terminal window.

5. Open the file src/FineCollectionService/test.http in the VS Code (file) Explorer. The request in this file simulates sending a detected speeding-violation to the FineCollectionService.

6. Click on Send request in the file to send a request to the API.

7. The response of the request will be shown in a separate window on the right. It should be a response with HTTP status code 200 OK and no body.

8. Check the logging in the terminal window. It should look like this:

   

At this point, both the Vehicle Registration and Fine Collection microservices are up and running.

Step 3. Run the TrafficControl service

1. Make sure the VehicleRegistrationService and FineCollectionService are running (results of step 1 and 2).

2. Open another new terminal window in VS Code and set the current folder to src/TrafficControlService.

3. Start the service using dotnet run.

4. Open the test.http file in the TrafficControl project folder in VS Code.

5. Click on Send request for both the Registry Entry and Register Exit requests in the file to send two requests to the API.

6. The response of the requests will be shown in a separate window on the right. Both requests should yield a response with HTTP status code 200 OK and no body.

7. Check the logging in the terminal window. It should look like this:

   

8. Also inspect the logging of the FineCollectionService.

   You can do this by selecting the prior terminal window using the dropdown in the title-bar of the terminal window:

   You should see the speeding-violation being issued by the FineCollectionService:

   

At this point, the three core microservices, Vehicle Registration, Fine Collection, and Traffic Control are up and running.

Step 3. Run the simulation

You've tested the APIs directly by using a REST client. Now you're going to run the simulation microservice that simulates cars driving on the highway. The simulation will simulate 3 entry- and exit-cameras (one for each lane).

1. Open a new terminal window in VS Code and set the current folder to src/Simulation.

2. Start the service using dotnet run.

3. In the terminal window you should see something like this:

   

4. Also check the logging in the other Terminal windows. You should see all entry- and exit events and any speeding-violations that were detected in the logging.

Now we know the application runs correctly. It's time to start adding Dapr to the application.

Next assignment

Make sure you stop all running processes and close all the terminal windows in VS Code before proceeding to the next assignment. Stopping a service or the simulation is done by pressing Ctrl-C in the terminal window. To close the terminal window, enter the exit command.

You can also close a terminal window by clicking on the trashcan icon in its title bar:

Go to assignment 2.