Gatsby Cloud Docs

Getting started with Gatsby Cloud and Azure Storage

Table of Contents

Gatsby Cloud integrates with Azure Storage, which is a storage service that can be used for hosting a Gatsby site so you can build and deploy seamlessly.

Prerequisites

With a site on Gatsby Cloud and an available Azure Storage Account, you can set up your site to publish newly built files to Azure.

You can use Gatsby Cloud Quick Start to provision a new Gatsby site. Alternatively, you can add an existing site to Gatsby Cloud by selecting that GitHub repository during set up.

Configuring Azure Storage Settings

You’ll first need to create an Azure Storage Account. After you have a Storage Account created, navigate to its “Settings” and then “Access keys”. Here you’ll find your “Storage account name” and “Connection string”, which you’ll need to setup the hosting integration with Gatsby Cloud. Select the connection string from the “key1” section.

A screenshot showing how to find the connection string and storage account name

You’ll also need to setup your Azure Storage Account to host a static website. Refer to the Azure docs on using Azure Storage for static website hosting for more information on configuring specific settings for your Azure Storage Account in the Azure Portal.

Note that this will create the a $web container in your Azure Storage Account. All files deployed from Gatsby Cloud will be uploaded to this container.

Setting Up the Hosting Integration

Once your site is available inside Gatsby Cloud you can “view details” and navigate to the “Site Settings” tab.

Inside Site Settings there is an “Integrations” link. Select this menu item and scroll down to the section titled “Hosting Integrations”.

This is where you’ll see the Azure logo. Click the “Connect” button to the right of that logo and you’ll be prompted to add some information:

  • Connection String
  • Storage Account Name

Enter the values that you recorded above and once you hit save, builds will automatically be deployed to Azure Storage.

Finishing Up

And that’s it! Your site is now set up to build and deploy. Gatsby Cloud will handle everything for you.

Note that you can only have one hosting integration. If you choose to configure another provider, that will override your existing Azure Storage integration.

FAQ

Can I put a CDN in front of Azure Storage?

Yes, you can configure Azure CDN to serve the files from Azure Storage, or connect your storage account to another preferred CDN.

© 2020 Gatsby, Inc.