Skip to content

storage-blob-static-website-host.md

Latest commit

 

History

History
119 lines (81 loc) · 5.78 KB

storage-blob-static-website-host.md

File metadata and controls

119 lines (81 loc) · 5.78 KB
title Tutorial: Host a static website on Blob storage
titleSuffix Azure Storage
description Learn how to configure a storage account for static website hosting, and deploy a static website to Azure Storage.
author stevenmatthew
ms.service azure-blob-storage
ms.topic tutorial
ms.date 11/04/2021
ms.author shaas
ms.reviewer dineshm
ms.custom ai-video-demo
ai-usage ai-assisted

Tutorial: Host a static website on Blob Storage

In this tutorial, you'll learn how to build and deploy a static website to Azure Storage. When you're finished, you will have a static website that users can access publicly.

In this tutorial, you learn how to:

[!div class="checklist"]

  • Configure static website hosting
  • Deploy a Hello World website

[!INCLUDE static websites vs static web apps]

This video shows you how to host a static website on Blob Storage.

[!VIDEO 61affe70-baf4-4b65-ba95-0a9d3e272032]

The steps in the video are also described in the following sections.

Prerequisites

[!INCLUDE storage-quickstart-prereq-include]

Note

Static websites are now available for general-purpose v2 Standard storage accounts as well as storage accounts with hierarchical namespace enabled.

This tutorial uses Visual Studio Code, a free tool for programmers, to build the static website and deploy it to an Azure Storage account.

After you install Visual Studio Code, install the Azure Storage preview extension. This extension integrates Azure Storage management functionality with Visual Studio Code. You will use the extension to deploy your static website to Azure Storage. To install the extension:

  1. Launch Visual Studio Code.

  2. On the toolbar, click Extensions. Search for Azure Storage, and select the Azure Storage extension from the list. Then click the Install button to install the extension.

    Install the Azure Storage extension in VS Code

Configure static website hosting

The first step is to configure your storage account to host a static website in the Azure portal. When you configure your account for static website hosting, Azure Storage automatically creates a container named $web. The $web container will contain the files for your static website.

  1. Sign in to the Azure portal in your web browser.

  2. Locate your storage account and display the account overview.

  3. Select Static website to display the configuration page for static websites.

  4. Select Enabled to enable static website hosting for the storage account.

  5. In the Index document name field, specify a default index page of index.html. The default index page is displayed when a user navigates to the root of your static website.

  6. In the Error document path field, specify a default error page of 404.html. The default error page is displayed when a user attempts to navigate to a page that does not exist in your static website.

  7. Click Save. The Azure portal now displays your static website endpoint.

    Enable static website hosting for a storage account

Deploy a Hello World website

Next, create a Hello World web page with Visual Studio Code and deploy it to the static website hosted in your Azure Storage account.

  1. Create an empty folder named mywebsite on your local file system.

  2. Launch Visual Studio Code, and open the folder that you just created from the Explorer panel.

    Open folder in Visual Studio Code

  3. Create the default index file in the mywebsite folder and name it index.html.

    Create the default index file in Visual Studio Code

  4. Open index.html in the editor, paste the following text into the file, and save it:

    <!DOCTYPE html>
<html>
  <body>
    <h1>Hello World!</h1>
  </body>
</html>

  5. Create the default error file and name it 404.html.

  6. Open 404.html in the editor, paste the following text into the file, and save it:

    <!DOCTYPE html>
<html>
  <body>
    <h1>404</h1>
  </body>
</html>

  7. Right-click under the mywebsite folder in the Explorer panel and select Deploy to Static Website... to deploy your website. You will be prompted to log in to Azure to retrieve a list of subscriptions.

  8. Select the subscription containing the storage account for which you enabled static website hosting. Next, select the storage account when prompted.

Visual Studio Code will now upload your files to your web endpoint, and show the success status bar. Launch the website to view it in Azure.

You've successfully completed the tutorial and deployed a static website to Azure.

Feature support

[!INCLUDE Blob Storage feature support in Azure Storage accounts]

Next steps

In this tutorial, you learned how to configure your Azure Storage account for static website hosting, and how to create and deploy a static website to an Azure endpoint.

Next, learn how to configure a custom domain with your static website.

[!div class="nextstepaction"] Map a custom domain to an Azure Blob Storage endpoint