Description

The end of life of Azure Kubernetes Service (AKS) 1.21 is July 2022. Sitecore Managed Cloud Containers solutions, based on AKS 1.21, need to be updated to a newer version that uses AKS 1.22. For more details on AKS end of life and the consequences of deprecation refer to here.

Update your solution only if the version you have is less than the ones listed below in Stage 2 of the Solutions section. To find out the version of your solution, view the solution.json file in the infrastructure repository of your Managed Cloud Containers Azure DevOps project.

This article contains upgrade instructions for the Sitecore Managed Cloud Containers solution to the version that uses AKS 1.22.

Breaking changes

Upgrading the AKS version from 1.21 to 1.22 introduces some breaking changes in Kubernetes API. These breaking changes do not lead to downtime but require additional changes to Sitecore Managed Cloud Containers environments, and should be applied to the 2-stages process defined below.

• A new release contains bug fixes and required changes to make the Sitecore Managed Cloud Containers environment compatible with the 1.22 AKS version.
• The upgrading process for Sitecore Managed Cloud Containers differs from the regular upgrade process and should be performed in 2 stages described below. Note that the mentioned package versioning is expected.
• During the upgrade, NO downtime for the AKS cluster is expected.

Upgrade instructions

There are two stages in upgrading the Sitecore Managed Cloud Containers solution:

• Stage 1:
  
  1. Download an upgrade package for the needed topology and version from the storage.
     There is a list of available upgrade packages:
     • Sitecore 10.1.0:
       
       • mcc.xp.upgrade.10.1.0-r.0.1.228921.nupkg
       • mcc.xm.upgrade.10.1.0-r.0.1.228921.nupkg
       • mcc.xc.upgrade.10.1.0-r.0.1.228921.nupkg
     • Sitecore 10.1.1:
       
       • mcc.xp.upgrade.10.1.1-r.0.1.228923.nupkg
       • mcc.xm.upgrade.10.1.1-r.0.1.228923.nupkg
     • Sitecore 10.1.2:
       
       • mcc.xp.upgrade.10.1.2-r.0.1.228922.nupkg
       • mcc.xm.upgrade.10.1.2-r.0.1.228922.nupkg
     • Sitecore 10.2.0:
       
       • mcc.xp.upgrade.10.2.0-r.0.1.228924.nupkg
       • mcc.xm.upgrade.10.2.0-r.0.1.228924.nupkg
         
         
  2. Install the upgrade package to your solution (follow the guideline for Sitecore 10.1 or Sitecore 10.2)
  3. Run the Infrastructure pipeline.
  4. Run the Application pipeline.
  5. Run the check cluster upgrades pipeline.
  6. Run the cluster version upgrade pipeline
     (kubernetes_version 1.22.* - select the latest available patch version received from the pipeline in step 5).
     
     
• Stage 2:
  
  1. Download an upgrade package for the needed topology and version from the storage.
     There is a list of available upgrade packages:
     • Sitecore 10.1.0:
       
       • mcc.xc.upgrade.10.1.0-r.0.1.228902.nupkg
       • mcc.xm.upgrade.10.1.0-r.0.1.228902.nupkg
       • mcc.xp.upgrade.10.1.0-r.0.1.228902.nupkg
     • Sitecore 10.1.1:
       
       • mcc.xm.upgrade.10.1.1-r.0.1.228903.nupkg
       • mcc.xp.upgrade.10.1.1-r.0.1.228903.nupkg
     • Sitecore 10.1.2:
       
       • mcc.xm.upgrade.10.1.2-r.0.1.228904.nupkg
       • mcc.xp.upgrade.10.1.2-r.0.1.228904.nupkg
     • Sitecore 10.2.0:
       
       • mcc.xm.upgrade.10.2.0-r.0.1.228905.nupkg
       • mcc.xp.upgrade.10.2.0-r.0.1.228905.nupkg
         
         
  2. Install the upgrade package into your solution (follow the guideline for Sitecore 10.1 or Sitecore 10.2).
  3. Run the Infrastructure pipeline.
  4. Run the Application pipeline.