Skip to main content

Deploy Sitecore Connect for Content Hub in a new PaaS environment

Abstract

How to deploy the Sitecore Connect for Content Hub connector in a new PaaS environment.

This topic describes how to use the Sitecore Azure Toolkit (SAT) to include the Sitecore Connect for Content Hub (SCCH) connector in a new Sitecore Azure Cloud Service (Paas) environment. The procedure depends on whether you have a Sitecore Experience Manager (XM) or Sitecore Experience Platform (XP) installation.

Note

If you have an existing Sitecore Azure PaaS environment, use the instructions in Walkthrough: Deploying Sitecore Connect for Content Hub in an existing PaaS environment instead.

This section explains what you must prepare before adding the Sitecore Connect for Content Hub (SCCH) connector to the Sitecore Azure Toolkit (SAT) configuration.

Before you add the SCCH module for SAT, you must have the following:

  • An Azure account with access to Azure cloud storage with Azure Storage Explorer.

To prepare for installation, download the following resources:

Note

For a comprehensive look at SAT deployment steps, see the Sitecore Azure Toolkit Overview and the Sitecore Azure Toolkit Deployment Guide .

To enable the SAT bootloader to perform post-step or transformation instructions, you must prepare the template scripts and bootloader resources and add them to Azure.

For Sitecore XM installation:

  1. Extract all the content in Sitecore Connect for Content Hub 5.0 WDP package to a new folder named, for example, WDP. Navigate to the Content\Website\bin\scch folder.

  2. For Sitecore XM version 10.0 and 10.1, copy the Microsoft.Extensions.DependencyInjection.Abstractions.dll assembly to the Content\Website\bin folder.

  3. For all versions of Sitecore XM, copy the Microsoft.Extensions.Caching.Abstractions.dll assembly to the Content\Website\bin folder.

  4. Repack the contents of the WDP folder into a new WDP package, and name it scwdp.zip, replacing the scwdp.zip in the original download.

  5. In Azure Storage Explorer, upload the following files to Azure blob Containers:

    File

    Source

    URL parameter

    azuredeploy.json

    Where you downloaded the SCCH ARM template script.

    Bootloader template URL

    scwdp.zip

    Content\Website\bin

    SCCH 5.0 template URL

    Sitecore.Cloud.Integration.Bootload.wdp.zip

    Sitecore Azure Toolkit\resources\{version}\Addons

    Bootloader WDP URL

    bootloader.json

    Where you downloaded the SXP ARM template script.

    ARM template URL

  6. In Azure Storage Explorer, for each uploaded file, click Copy URL and save the URL to use as the URL parameter mentioned in the table.

    Azure Storage Explorer dialog with uploaded files
  7. On your server, in the Sitecore Platform ARM template folder, open the azuredeploy.parameters.json file.

  8. Add a new parameter named modules, and fill in the URLs you saved:

    "modules": {"value": {"items": [
        {"name": "bootloader","templateLink": "<Bootloader template URL>","parameters": {"msDeployPackageUrl": "<Bootloader WDP URL>"}},
        {"name": "SCCH 5.0","templateLink": "<SCCH 5.0 template URL>","parameters": {"msDeployPackageUrl": "<ARM template URL>"}}
    ]}}}
  9. Continue with the steps of deploying a new Sitecore environment to the Microsoft Azure App service. In the final step, after you invoke the deployment command in PowerShell, wait for the PowerShell script to complete all the tasks.

  10. In the Azure resource group, on the Deployments tab, verify the deployment status for the bootloader and SCCH 5.0:

    Deployments tab in the Azure resource group dialog

To enable the SAT bootloader to perform post-step or transformation instructions, you must prepare the template scripts and bootloader resources and add them to Azure.

For Sitecore XP installations:

  1. In Azure Storage Explorer, upload the following files to Azure blob Containers:

    File

    Source

    URL parameter

    azuredeploy.json

    Where you downloaded the SCCH ARM template script.

    Bootloader template URL

    scwdp.zip

    Content\Website\bin

    SCCH 5.0 template URL

    Sitecore.Cloud.Integration.Bootload.wdp.zip

    Sitecore Azure Toolkit\resources\{version}\Addons

    Bootloader WDP URL

    bootloader.json

    Where you downloaded the SXP ARM template script.

    ARM template URL

  2. In Azure Storage Explorer, for each uploaded file, click Copy URL and save the URL to use as the URL parameter mentioned in the table.

    Azure Storage Explorer dialog with uploaded files
  3. On your server, in the Sitecore Platform ARM template folder, open the azuredeploy.parameters.json file.

  4. Add a new parameter named modules, and fill in the URLs you saved:

    "modules": {"value": {"items": [
        {"name": "bootloader","templateLink": "<Bootloader template URL>","parameters": {"msDeployPackageUrl": "<Bootloader WDP URL>"}},
        {"name": "SCCH 5.0","templateLink": "<SCCH 5.0 template URL>","parameters": {"msDeployPackageUrl": "<ARM template URL>"}}
    ]}}}
  5. Continue with the steps of deploying a new Sitecore environment to the Microsoft Azure App service. In the final step, after you invoke the deployment command in PowerShell, wait for the PowerShell script to complete all the tasks.

  6. In the Azure resource group, on the Deployments tab, verify the deployment status for the bootloader and SCCH 5.0:

    Deployments tab in the Azure resource group dialog