Deploying Commerce to Azure Web Apps (Commerce 8)

ARCHIVED This content is retired and no longer maintained. See the latest version here.

Requirements

The Azure Management Portal requires an account with login details.
A specific cloud enabled license is required, refer to the EPiServer License Center to get this.
Deploying to cloud based websites requires that each deployed application and module is designed for cloud.

For sites upgraded from 7.5 and higher, refer to Upgrading and deploying Commerce to Azure Web Apps for more information.

Cloud website setup

Like EPiServer CMS webite on Azure, the Commerce website can be run on Azure Web Site environment with multiple instances. The website instances share the same Azure SQL database, and the blob storage in Azure is used for storing of the file binary data. Load balancing is applied and the Azure Service Bus manages events between the CMS websites.

Follow the steps below to create an EPiServer Commerce website running in an Azure Apps environment.

1. Creating a site

In Visual Studio, select Tools > Extensions and Updates menu. In the dialog, select Online and Search EPiServer CMS Visual Studio Extension then install extenstion. Refer to Visual Studio Gallery for more information about EPiServer Extension.
Create a new project by selecting New > Project > Visual C#, and then EPiServer > EPiServer Web Site. In the dialog select Empty, uncheck "Add EPiServer Search", to use search functionality when running in Azure see section "Search in Azure" on Deploying to Azure Web Apps.
Install the NuGet package EPiServer.Commerce, to latest version (or 8.12 at least).
Install the NuGet package EPiServer.Commerce.Azure to the project.
Add the cloud license to the website, this will be used and activated later when deploying the website to Azure.

2. Creating Azure resources

Refer to section "Creating Azure resources" on Deploying to Azure Web Apps for more information.

3. Updating configurations

Refer to section "Updating configuration" on Deploying to Azure Web Apps for more information.

4. Deploying

Refer to Deploying section on Deploying to Azure Web Apps for more information about how to deploy an EPiServer site.

Note that since Commerce has two databases, we need to add two scripts in the Add SQL Script step:

EPiServer.Cms.Core.sql under [SolutionDir]\packages\EPServer.CMS.Core.x\tools\ to EPiServerDB
EPiServer.Commerce.sql under [SolutionDir]\packages\EPiServer.Commerce.Core.x\tools\ to EcfSqlConnection

When the database has been successfuly created, run the Update-EPiDatabase command in the Package Manager Console.

5. Changing the site URL

Refer to Changing the site URL section on Deploying to Azure Web Apps for more information about how to config the site URL.

6. Build site index

Build content index

Refer to Search in Azure section on Deploying to Azure Web Apps for more information about how to build the content index.

Rebuild catalog index

Access Commerce Manager.
Go to Administration > System Settings > Search Index, click on Rebuild Index, the catalog index will be restored in your storage.

Note: If you are using LuceneSearchProvider as default search provider, you need to do some more extra steps:

Open Mediachase.Search.config, in SearchProviders, and set the attribute defaultProvider to LuceneAzureSearchProvider.
Set your connectionStringName so that the provider has the name="LuceneAzureSearchProvider" matching with your Azure Storage name (in connectionStrings.config) and storage="<container you want to index>".
Set the connectionStringName in Indexers tab matching with your Azure Storage name (in connectionStrings.config) and basePath is "<container where you want to store build info>".

Example of search config in Mediachase.Search.config, defined for using Lucene on Azure:

XML

<?xml version="1.0" encoding="utf-8"?>
<Mediachase.Search>
  <SearchProviders defaultProvider="LuceneAzureSearchProvider">
    <providers>      
      <add name="LuceneSearchProvider" type="Mediachase.Search.Providers.Lucene.LuceneSearchProviderMediachase.Search.LuceneSearchProvider" 
        queryBuilderType="Mediachase.Search.Providers.Lucene.LuceneSearchQueryBuilder, Mediachase.Search.LuceneSearchProvider"
        storage="<your_physical_path_index>" simulateFaceting="true"/>
      <add name="LuceneAzureSearchProvider" type="Mediachase.Search.Providers.Lucene.LuceneAzureSearchProvider, Mediachase.Search.LuceneAzureSearchProvider"
        queryBuilderType="Mediachase.Search.Providers.Lucene.LuceneSearchQueryBuilder, Mediachase.Search.LuceneSearchProvider" 
        storage="indexcontainer" connectionStringName="EPiServerAzureBlobs" simulateFaceting="true"/>
    </providers>
  </SearchProviders>
  <Indexers basePath="indexcontainer" connectionStringName="EPiServerAzureBlobs"> 
    <add name="catalog" type="Mediachase.Search.Extensions.Indexers.CatalogIndexBuilder, Mediachase.Search.Extensions"/>
  </Indexers>
</Mediachase.Search>

Note: You need to install Episerver.Commerce.Azure to use Mediachase.Search.LuceneAzureSearchProvider .

Deploying Commerce to Azure Web Apps