Deploy a new Sitecore environment to the Azure App Service

Last updated Friday, November 17, 2017 in Sitecore Azure Toolkit for Administrator, Developer
Keywords: Azure, Cloud

With the Sitecore Azure Toolkit, you can deploy a new Sitecore environment to the Microsoft Azure App Service®.

This topic describes how to:

Plan your environment

When planning the Sitecore environment to deploy via the Sitecore Azure Toolkit there are a number of decisions that you must make to ensure the correct resources are prepared. These include:

  • Choosing the right configuration of Sitecore - for example, should the deployment be for the Sitecore Experience Platform or for the Sitecore Experience Manager.
  • Sizing the deployment - the Sitecore Azure Toolkit provides the ability to scale the resources for your configuration to match the expected use of the solution. It allows you to size from a minimal developer/testing type environment to a large-scale production deployment suitable for millions of visits per month.
  • Selecting which additional Sitecore modules you want to deploy alongside the platform - for example, Sitecore Email Experience Manager (EXM).

The Sitecore Azure Toolkit supports multiple variations of the options above, dependent on the version you are installing. Refer to the table below for help with planning.

Sitecore version

Configuration information

8.2 (all versions)

Deploy a new Sitecore environment to the Azure App service

9.0 (all versions)

Sitecore configurations and topology for Azure

Prepare WebDeploy packages

The Azure Resource Manager (ARM) requires that WebDeploy packages (WDPs) containing the application code and resources are available to download over the Internet. One option to host WDPs is to create a Microsoft Azure® storage account.

To prepare the WDPs and host within a Microsoft Azure® storage account:

  1. Ensure you have access to a Microsoft Azure subscription to deploy a Sitecore environment.
  2. Create a Microsoft Azure storage account.
  3. In the Microsoft Azure storage account menu, Blob Service, click Containers, and add a container.
  4. If you are installing a new standard Sitecore configuration, go to the Sitecore Experience Platform Download page and download the prebuilt WDPs for the size and Sitecore configuration that you have planned for. If you want to install a customized deployment of Sitecore, you can create your own WDPs by using the Sitecore Azure Toolkit to package them. Remember, they must be suitable for the planned Sitecore configuration and size.
  5. Use Azure Storage Explorer to connect to a Microsoft Azure storage account and upload the Sitecore WDPs for your configuration to the container that you created earlier.

    Note

    WDPs have the.scwdp.zip extension and contain the role name as part of the file name, for example, Sitecore 9.0 rev. 161117_cm.scwdp.zip. When you download the WDPs from the Sitecore Experience Platform Download page, they are delivered in a zip file. You must unzip them from that file before you can upload them to Microsoft Azure storage.

    AzureStorageExplorer_SitecoreAzureToolkit_90_Cloud

  6. In Azure Storage Explorer, create a Shared Access Signature (SAS) token for the storage container. The SAS allows temporary access to the WDPs during the deployment process. When you create the SAS token, ensure that you allow enough time between the Start time and Expiry time to guarantee access during the scheduled deployment.

    AzureStorageExplorerSAS_SitecoreAzureToolkit_90_Cloud_screenshot

  7. Copy and make a note of the value in the Query string field because this contains the token.

    AzureStorageExplorerQS_SitecoreAzureToolkit_90_Cloud_screenshot

    Note

    The URL and SAS token are required for later use in the ARM templates, so for each WDP that you upload, take a note of its URL and append the SAS token to it. For example:

    https://examplestorage.blob.core.windows.net/examplecontainerwdp/Sitecore%209.0%20rev.%20171128_cd.scwdp.zip?st=2017-09-01T10%3A04%3A00Z&se=2017-09-28T10%3A04%3A00Z&sp=rl&sv=2015-12-11&sr=c&sig=8X5xhtTCxxXlcLmTmtZX4dx1tFtx4w9lX43qYJA4ZBQ%3D

Deploy the right version of Sitecore

With Sitecore Azure Toolkit you can deploy multiple different versions of Sitecore. Each version has the potential to contain different dependencies and requirements for deployment. Refer to the table below to ensure you follow the specific deployment instructions for the version you want to install.

Sitecore version

Configuration information

8.2 (all versions)

Deploy a new Sitecore environment to the Azure App service

9.0 (all versions)

Walkthrough: Deploy a new Sitecore environment to the Azure App service

Send feedback about the documentation to docsite@sitecore.net.