Chris Reddington

Published on Wed, Jul 28, 2021

Static Websites Hugo Static Content

If you’ve seen any of my community talks, then you’ll be aware that Static Websites and the Static Content Hosting Pattern is a passion area of mine. In Azure, there are a couple of great services that stand out when building towards this approach. These are Azure Static Web Apps and the Static Websites functionality in Azure Blob Storage. But, which one is right for your scenario? Read on to find out more.

The Static Content Hosting Pattern is essentially a way to serve up static assets to your end-users without using expensive compute (i.e. servers). Typically, this is achieved by using services like Azure Blob Storage, Amazon S3, Google Storage Buckets or similar. In general, this pattern doesn’t have to be about serving websites, but that will be the focus throughout this post.

This pattern lends itself well to the modern web development paradigm of JAMStack. The JAM in JAMStack stands for Javascript, APIs and Markup (hence JAM). Ultimately, this relies on a number of modern development practices (such as version controlled source files; a build pipeline to ensure the raw markdown files can be compiled into the final HTML, CSS, JavaScript and images that are ultimately served up to an end-user’s web browser).

Now given that context, what are our options to deploy a Static Website onto Azure? There are of course more options than the initial two which we’ll focus on, but these two are some great candidates to begin with.

Azure Static Web Apps

Azure Static Web Apps was launched as a preview service in May 2020, and went Generally Available in May 2021. It is a Platform as a Service (PaaS) option which provides a number of great features out of the box, including -

  • Ability to quickly create a GitHub Action Workflow or integration with Azure Pipelines
  • Automatic provisioning of staging environments
  • Free SSL Certificates
  • Ability to associate custom domains
  • Ability to deploy Azure Functions as part of your Static Web App deployment, for a true serverless website
  • Ability to easily integrate Authentication and Authorization capabilities into your website

I put together a longer writeup about Azure Static Web Apps when it went Generally Available, so I’d encourage you to read that one as well.

Static Websites on Azure Storage

The Static Websites on Azure Storage feature went Public Preview in June 2018, and went Generally Available in December of the same year.

If you’re familiar with Azure Blob Storage, then you’ll be comfortable using the static Websites feature of Azure Blob Storage. When you enable the static website functionality, it simply creates a $web blob container in your Azure Storage Account. You will also see that there is a new URL endpoint available to access the assets stored under this container.

Any files that are available in the $web container can be served up through a web browser, by using the new endpoint mentioned above. Unlike Static Web Apps, there is no additional functionality for Single Page Applications. It is a very simple offering, and does exactly what it intends to do - provide an option to host static web assets and expose them to the internet.

While the functionality in Azure Storage is basic (in comparison to Azure Static Web Apps), that doesn’t mean that it’s impossible to replicate the functionality available in Azure Static Web Apps. You could consider Azure Static Web Apps as a turnkey approach for Single Page Applications, whereas Static Websites on Azure Storage requires some additional work.

For example, the website you’re reading (Cloud With Chris) is - and has been - hosted using the Static Websites on Azure Storage approach since March 2020. As an end-user, when you navigate to, you’ll be routed to an Azure CDN instance that is fronting the Azure Storage Account which hosts the production Static Website. The CDN is how I’m able to have an SSL Certificate mapped against a Custom Domain, otherwise that wouldn’t be possible directly on the storage account (as there’s no way to map a custom SSL certificate in that way directly).

I also have a capability to render staging instances of my website. Just take a look over at or As you would expect, each of these instances are behind a CDN endpoint. Once again though, this is not a turn key solution. This has been a significant amount of work.

First, piecing together my own deployment pipeline. The first step of my process is triggered when a Pull Request is created to merge a preview branch into dev. This creates a new subdirectory in the $web container of my Cloud With Chris preview storage account. Once approved and merged to dev, then the next step is to upload the assets to the Cloud With Chris Staging Storage Account (aka my dev environment, ready for go-live). Once all checked and ready to go, these changes are merged to the main branch. This triggers a release to the Cloud With Chris production storage account, and purges the CDN endpoint for production.

Authentication and Authorization could be added to my Static Website hosted in Azure Storage, but this require upfront planning in terms of identity providers, a service to enable that and then adding the functionality into the application. With Azure Static Web Apps, there is a streamlined experience to set this experience up and enable it within your application.

So, which one is right for me?

Ultimately, you need to make a judgement call. Do you want something which enables you to get moving quickly and deploy your Single Page Application (SPA) quickly? Or, would you rather have a little more control and granularity, and focus on the underlying building blocks?

Personally, if I were starting with a new website - it would be an easy decision in my opinion. I would choose Azure Static Web Apps, as it takes a large amount of overhead away from me. Not only that, but if my site is a community/hobby site, then there is even a free tier available! The standard tier does not have a significant cost associated with it though, and certainly won’t break the bank.

I will likely migrate Cloud With Chris to Azure Static Web Apps over time, but the Static Websites on Azure Storage approach works for me right now. As nothing is broken, I don’t plan on making any fixes anytime soon :)


Overall, this has been a very short blog post - pulling together some thoughts on a couple of options that I see in this space. Are you running any Static Websites? How are you hosting them, whether on Azure, or other platforms? Let me know over on Twitter, @reddobowen.

Thanks for reading, and until the next post - bye for now!


JAMStack and the Cloud - A winning combination


JAMStack and the Cloud - A winning combination

When I mention the term JAMStack, I’m not pretending that I’m Paddington bear with a stack of Jam sandwiches! If you hadn’t heard, JAMStack is a term that describes applications based on JavaScript, APIs and Markup. That means, we’re referring to files that are content in …

Development Static Content Hugo Cloud Design Patterns Web Development Azure CosmosDB Azure Storage Serverless

Chris Reddington Published on Wed, Jan 20, 2021

22 - Static Content Hosting Pattern (Save cost and gain performance for static websites!)


22 - Static Content Hosting Pattern (Save cost and gain performance for static websites!)

Do you have a website that is made up mostly of Static Content (e.g. HTML, JavaScript, CSS, Images)? Interested how you can optimise for performance and cost savings as well? Then join this episode as we talk through the Cloud Design Pattern, “The Static Content Hosting Pattern”. This is …

Architecture Hugo Static content

Architecting for the cloud, one pattern at a time

Chris Reddington Published on Fri, Jan 15, 2021

How GitHub Actions can help in building and deploying a static website and more


How GitHub Actions can help in building and deploying a static website and more

Chris is a Cloud Solution Architect at Microsoft. He’ll provide an overview of GitHub and explore how GitHub Actions can be used to build and deploy your own static websites (or other apps!) to Azure.

DevOps GitHub Deployment GitHub Actions Static Content

Chris Reddington Occured on Tue, Jul 20, 2021

Static Web Apps in Azure |


Static Web Apps in Azure |

We often hear about Kubernetes, App Services, VMs and more. What about static sites? The Static Content Hosting pattern can be cost-effective, and when combined with a CDN can be incredibly performant! We will get hands-on, showing how these resources come together into a Cloud Architecture.

DevOps GitHub Deployment GitHub Actions Static Content GitHub Issues GitHub Codespaces Visual Studio Code

Chris Reddington Occured on Wed, Jun 9, 2021