Journey Towards Cloud Architecture
Published Sep 23 2021 08:53 PM 7,710 Views

In this article, @i-am-dan and @pjirsa (Microsoft’s Cloud Solutions Architects) highlight the benefits of a modern event-based cloud architecture while migrating a legacy WebAPI to Azure.


Our Story

Our legacy API (Hackathon registration service)


(Figure 1)


Figure 1 represents the architecture of our original Hackathon Registration service.

It includes the following components:

  • Registration Form — A website which collects registration info from a new hackathon participant.
  • Registration API — An ASP.NET Core WebAPI providing CRUD over the registration data.
  • Registration DB — An Azure SQL Database to persist registration data.

Over time, additional functionality and business logic have been added to the legacy API. Some examples are:

  • Adding a new user to a mailing list service (Mailchimp).
  • Inviting new guest users to an Azure AD tenant.
  • Adding a new user to a Microsoft Teams team and channels.

And more requirements mean more code!

Our technical debt and existing design patterns were making it challenging to adapt to the new requirements.


While the core functionality of collecting and storing user registration information remains constant, each hackathon event usually has its own requirements around other capabilities. Some events want to use an alternate mailing list provider. Others want to configure a unique hierarchy for teams and channels. Our API codebase quickly started filling up with conditional statements and logical branches making it nearly impossible to test and difficult to maintain.


While the American divorce rate has dropped, we knew the answer to our problem was to decouple. We want to decouple what we currently have into separate components. Each component takes care of an atomic piece of business logic and should be easily modifiable without disrupting other components. This removes the need to bake unnecessary code into our base business logic. We decided to take a spike and design out how we can accomplish that using out of the box Azure services.


What does this have to do with me?

Though this API is a small example we believe componentizing your architecture while it’s still small is a big step towards modernizing your architecture.


As developers, we believe in Clean Code. We have to think software architecture, similarly. Each small component is doing only what it is supposed to and then passes control to another component. This helps us to architect cleaner and sensible solutions in the cloud.


Whether you are already on the cloud or just thinking about modernizing your current architecture for the cloud, this article will hopefully give you a decent grasp of how you can go about approaching it the right way — or at least a better way. There’s no one design pattern to address all solutions of course.


Options Options Options


App Service

One of the quickest way to modernize your software is using Azure App Service. This way you allow Azure to handle all the networking and security for you. Here are some great ways to secure your App Services!

(VM is of course another route but going back to our reasoning we want to make sure things are small and manageable.)


You can either host all your messy giant application in the App Service, OR you can refactor like mentioned above and put them into separate App Services and this gets into the territory of Microservices.


Did we mention the cost can be significantly cheaper?



One step further than an app service route is the Serverless Azure Functions route. This is where Azure dynamically manages the allocation and provisioning of servers. All the benefit of the App Service but with added bonus of being only charged when it’s invoked. Scott Guthrie calls it the ‘invocation model’ where you are only responsible for chargers when the resource is called.


Now… the fun(?) part!



Events and Messages

As you manage multiple components, event and messaging architecture becomes very important. We want our services to communicate and respond to each other. However, if we make direct calls between them, we are re-introducing strict dependencies. Ideally, these services should be able to communicate without needing any specific knowledge about what those services are, or where they are located. To accomplish this, we introduce an eventing system.


Should I use events or messages?

  • Events Think of it as a notification. The sender of an event does not necessarily care who receives or acts on the event. Eventing systems typically provide confirmation that an event has been submitted, and no response to the sender that a subscriber has consumed or processed the event.
  • Messaging Think of it as a task given by System A to System B. Messages usually contain a data payload. Messaging systems can accommodate a more formal relationship between a publisher and a subscriber. The sender generally knows who the consumer will be and is sending a data payload that the consumer expects for processing.

Whichever direction you go you need a Broker.


The broker we chose for our example is Azure Event Grid.

> Checkout the doc which explains different event-driven services in Azure


Our Solution


(Figure 2) represents the architecture of our refactored solution.


The core functionality of the API is still there. But we have moved all the customizable supporting features out to their own services.


In order to decouple them from the original API, and orchestrate the business logic, an Event Grid Topic has been implemented. This service receives event notifications from the API when operations are performed on the registration data.


Our supporting feature services can subscribe to these notifications to take the appropriate action when changes in the system occur.


What are the benefits?

The immediate impact of this redesign is tremendous.

  • Each component is completely autonomous. Interdependencies are decoupled and cross-service communication is faciliated by a highly fault-tolerant messaging system.
  • Cyclomatic Complexity of each component is greatly reduced. In some cases reaching a perfect score. This has the added benefit of making the code easier to test and easier for developers to understand. Not only are unit tests easier, but integration testing can be done by testing each component individually. For example, before the changes, we would have to submit an entire “new user” request through the API to make sure that the “Add to Mailchimp” feature was working properly. Now, we can just test that one service on its own.
  • Updates to the system are much easier now. Each of the supporting services are “plug-n-play”. For example, we can easily swap out the Mailchimp service for another service that interfaces with SendGrid.
  • Event Grid allows multiple subscriptions to the same event, which makes adding new features and layering in additional business logic a snap.


The downside

You might be saying, “But now there are so many more ‘things’ to deal with!”. Yes, that is true. But the benefits FAR out-weigh the downsides here. Cloud platforms (such as Azure) provide a wealth of governance and management tools out of the box that make it easy to provision, manage, and monitor ‘all the things’.


Lesson to be learnt

In hindsight I guess we got to this point because we didn’t have a good design discussion when the API was being created.


But I’m sure lot of development shops do similar things. In order to push code out, the design you think is going to last doesn’t really do you any good, OR you just write code without designing at all! IT’S OK! The point is to LEARN from what you have built and try to continuously improve.


The cloud offers flexibility. A light-weight, adaptable design for the cloud is more resilient to changes in feature requirements. As your needs change and grow, you are not locked in to the server or license you bought last year, you can scale up, down, out and in whenever you need to and the cost is only for what you use.


The Final Word

Migrating legacy application architectures to the cloud sometimes requires a shift in perspective and thought-process. These cloud-native patterns can seem foreign and complicated at first. But with a little time and experience you will start to see the flexibility, scalability, and cost benefits of these designs.

Version history
Last update:
‎Sep 23 2021 08:53 PM
Updated by: