Dynamic Website - Detailed Architecture

If you plan to build a dynamic website that integrates several SaaS applications and supports some complex functionalities, and with Contentstack as its CMS, your architecture should ideally look like the one given below. You can alternatively start with a simple website and add more capabilities as you grow to eventually have a set up like this:

Dynamic_Website_-_Detailed_Arhitecture.jpeg

(Download Diagram: PDF, SVGJPEG, and VSDX)

Diagram Overview

When a user requests for a page through a browser or any device, the request is served through the CDN cache, if available. If the cache is not available, the request is sent to your application (via load balancers). Your app generates the requested page (after fetching content from Contentstack) and sends it to the user. Contentstack interacts with other SaaS apps to help provide the best possible experience to the client or to the content manager.

Detailed Explanation

We can divide the architecture into the following components:

  • IaaS - Infrastructure as a Service
  • SaaS - Software as a Service
  • CDN - Content Delivery Network

SaaS (Software as a Service) Layer

Setting up a headless architecture enables you to adopt a microservices approach, where you can plug in and replace applications with ease. Your app can communicate and work with different SaaS applications through APIs. Let’s look at examples of some of the popular SaaS apps that most simple websites use and how they interact with the other components of your architecture.

  • The content that your app will eventually deliver to your website visitors is created and managed within Contentstack. Contentstack communicates with other SaaS apps as well as your application, as required. We will look at the details of this communication below.
  • A Single Sign-On (SSO) service, such as Okta, enables you and your team members to access company applications, such as Contentstack.
    • You can integrate Okta with Contentstack easily to provide single sign-on to your CMS through Okta.  
    • When any user wants to access Contentstack (through credentials), the request is directed through Okta to Contentstack. 
    • Okta creates a secured channel and requests Contentstack to provide access to that particular user. 
    • Contentstack, after validating the user, sends a token to Okta. By using this token the user gets access to Contentstack.
  • A SaaS service, such as commercetools, can be integrated with Contentstack as a custom field. 
    • The commercetools custom field fetches product details and relevant product assets from Contentstack and displays them in the field itself. 
    • The custom field also fetches product's price details, cart and transaction information from the commercetools platform through APIs. This makes it possible for the client to see the product content and execute transactions on his browsers or other devices.
  • Another SaaS service, such as Brightcove, can be integrated with Contentstack as a custom field to manage videos for your pages (entries) in Contentstack. 
    • By using the Brightcove custom field, you can populate videos from the Brightcove video library in the entry of your content type.
    • The user can then fetch the videos from the library and insert them into the field of their entry. 
  • To implement personalization in your website, you can integrate a service such as Dynamic Yield, with Contentstack as a dashboard widget. 
    • Dynamic Yield fetches the content from Contentstack and performs different experiments on your content. 
    • The results of these experiments are pushed back to Contentstack which can be viewed on your Contentstack dashboard. 
    • This experiment data is then forwarded to other third party services via the internet gateway. 
  • Marketo Forms represents a SaaS provider that helps you create marketing forms (for product campaigns, etc.) for your app.
    • It is connected with Contentstack (as a custom field extension) so that it can be added easily to the entries for form filling. 
    • When Marketo Form is connected with Contentstack as a custom field, you can easily select a form (from different available form options) and add it to your entries. When the page loads on the frontend, the form also loads through and embedded code. 
  • You can use Google Analytics to get analytics of your website usage. 
    • While you can fetch data directly from Google Analytics, it can also be connected with Contentstack as an extension (as a custom widget or dashboard widget). 
    • By using it as an extension, you can see user behavior of each entry within the entry page, or show overall analytics on Contentstack’s stack dashboard.
  • You can integrate a search service such as Algolia with Contentstack for carrying out search operations on your Contentstack-powered website. 
    • It helps with crawling the data (data indexing) to add the updated content in its databases.
    • The user using a browser or mobile device initiates a search request. This request is accepted by Algolia and then it fetches the required results and displays them to the user. 
  • A translation SaaS service such as Memsource can be integrated with Contentstack to enable users to translate content into a language of their choice. 
    • You can create locals in Contentstack and save the localized entries. 
    • Memsource, if integrated with Contentstack, gets notified of this through a webhook. It then fetches the content from Contentstack and performs content translation in the required language. 
    • Once the translation completes, it sends the translated content back to Contentstack which can be viewed within the entry in Contentstack. 
  • For Digital Asset Management (DAM), you can integrate a service, such as Bynder with Contentstack as a custom field. 
  • By using the Bynder custom field, you can populate assets from the Bynder image or asset library in the entry of your content type. 
  • The user can then fetch the assets from the library and insert them into the field of their entry.

IaaS (Infrastructure as a Service) Layer

This layer is where your app infrastructure sits. It holds your application code, frontend server, load balancers, firewalls, and other important components. Some of the services will be offered by your cloud infrastructure provider (such as AWS, Azure, or Google Cloud), while you may need to set up the other parts.

  • Set up an auto-scaling group that auto-scales on demand. This group would contain your frontend app cluster, load balancer and firewall.
  • The load balancers help your app distribute traffic to different servers, generally front-end servers.  
  • Network filtering through firewalls allow only legitimate requests to enter your infrastructure.  
  • You can set up multiple instances of your frontend app (aka frontend app cluster), with each one containing the frontend server and your app code.
  • Frontend servers provide all functionalities and services to ensure all connected microservices and Contentstack have the expected infrastructure to operate smoothly.
  • When the client requests for any data, it is first served through the CDN. If it is not available in CDN, the request is passed on to the application servers, where the page is created and served to the client through the CDN. The app fetches content from Contentstack via Contentstack’s Content Delivery APIs.

CDN (Content Delivery Network) Layer

  • A CDN is responsible for serving user requests through caches. You can use a CDN service, such as Fastly, to deliver content quickly to your clients.
  • All user requests first hit the CDN. If it has the cache of the requested content, it delivers it to the client. Else, it asks the app to provide updated content.
  • It also reduces the load on the server as the content is delivered through cache, instead of having to fetch content from your app every time.
  • You can set up load balancers to filter out unwanted requests and manage network traffic and reverse proxy (for masking) between the CDN and the headless infrastructure.

Next Steps

More Architecture Diagrams

Resources to Get Started

Was this article helpful?

Thanks for your feedbackSmile-icon

On This Page

top-arrow