This hack contains several hands-on challenges that will introduce you to Dapr. You will start with a simple ASP.NET Core application that is composed of several microservices. In each challenge, you'll enhance the application by adding Dapr building blocks and components. At the same time, you'll configure the application to consume Azure-based backing services. When complete, you'll have implemented the following Dapr building blocks:
- Service invocation
- State-management
- Publish / Subscribe
- Bindings
- Secrets management
As Dapr can run on a variety of hosts, you'll start by running Dapr in self-hosted mode on your computer. Then, you'll deploy the Dapr application to run in Azure Kubernetes Service and/or Azure Container Apps.
The challenges implement a traffic-control camera system that are commonly found on Dutch highways. Here's how the simulation works:
There's 1 entry-camera and 1 exit-camera per lane. When a car passes an entry-camera, a photo of the license plate is taken and the car and the timestamp is registered.
When the car passes an exit-camera, another photo and timestamp are registered. The system then calculates the average speed of the car based on the entry- and exit-timestamp. If a speeding violation is detected, a message is sent to the Central Fine Collection Agency (or CJIB in Dutch). The system retrieves the vehicle information and the vehicle owner is sent a notice for a fine.
- Challenge 0: Install local tools and Azure prerequisites
- Install the prerequisites tools and software as well as create the Azure resources required.
- Challenge 1: Run the TrafficControl application
- Run the Traffic Control application to make sure everything works correctly.
- Challenge 2: Dapr Service Invocation
- Add Dapr into the mix, using the Dapr service invocation building block.
- Challenge 3: Dapr Pub/Sub Messaging
- Add Dapr publish/subscribe messaging to send messages from the
TrafficControlServiceto theFineCollectionService.
- Add Dapr publish/subscribe messaging to send messages from the
- Challenge 4: Dapr Redis State Management
- Add Dapr state management in the
TrafficControlServiceto store vehicle information.
- Add Dapr state management in the
- Challenge 5: Dapr SMTP Output binding
- Use a Dapr output binding in the
FineCollectionServiceto send an email.
- Use a Dapr output binding in the
- Challenge 6: Dapr MQTT Input Binding
- Add a Dapr input binding in the
TrafficControlService. It'll receive entry- and exit-cam messages over the MQTT protocol.
- Add a Dapr input binding in the
- Challenge 7: Dapr Secrets Management
- Add the Dapr secrets management building block.
- Challenge 8: Dapr-enabled Services running in Azure Kubernetes Service (AKS)
- Deploy the Dapr-enabled services you have written locally to an Azure Kubernetes Service (AKS) cluster.
- Git (download)
- .NET 6 SDK (download)
- Visual Studio Code (download) with the following extensions installed:
- Docker for desktop (download)
- Dapr CLI and Dapr runtime (instructions)
- Install Azure CLI
- Linux (instructions)
- macOS (instructions)
- Windows (instructions)
- Install Bicep extension for VS Code (instructions)
- If you're running Windows, you'll need to install a bash shell to run some of the commands. Install either the Git Bash client or the Windows Subsystem for Linux 2.
./Coach/Solutions- Coach's Solutions and related files
./Student/Resources- Student's Challenge Guide
- Jordan Bean
- Eldon Gormsen
- Sander Molenkamp
- Scott Rutz
- Marcelo Silva
- Rob Vettor
- Edwin van Wijk
- Chandrasekar B
- Alberto Diaz