Sitecore Azure Toolkit

Deploy a new Sitecore environment to Azure App Service

Abstract

Use the Sitecore Azure Toolkit to deploy a new Sitecore environment to the Microsoft Azure App service.

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

This topic describes how to:

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)

Contained in this topic

9.0 (all versions)

Sitecore configurations and topology for Azure

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:

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.

    MicrosoftAzureStorageExplorer.png
  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.

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

    SharedAccessSignature.png

    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