Description

The end of life of Azure Kubernetes Service (AKS) 1.30 is Jul 2025. Sitecore Managed Cloud Containers solutions, based on AKS 1.30, need to be updated to a newer version that uses AKS 1.31. For more details on AKS end of life and the consequences of deprecation refer to Microsoft documentation.

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

Breaking Changes

• There is one breaking change in this release in regards to DR.
  Application Insights managed workspaces - Azure Monitor
  
  Beginning in April 2025, classic Application Insights resources are automatically migrated to workspace-based resources. Due to this our terraform would not be aware of the Microsoft managed workspace to manage it.

• The solution to this is to update the infrastructure pipeline remote-mcc-modules to version 1.0.17 prior to upgrade, as follows:
  
  

For all versions, downtime will be encountered during the upgrade process.
The upgrading process for Sitecore Managed Cloud Containers should be performed as described below.

Upgrade Instructions

Follow these steps to upgrade the Sitecore Managed Cloud Containers solution to the version that uses AKS 1.31:

1. Download an upgrade package for the needed topology and a 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.503956.nupkg
     • mcc.xm.upgrade.10.1.0-r.0.1.503956.nupkg
   • Sitecore 10.1.1:
     • mcc.xp.upgrade.10.1.1-r.0.1.503957.nupkg
     • mcc.xm.upgrade.10.1.1-r.0.1.503957.nupkg
   • Sitecore 10.1.2:
     • mcc.xp.upgrade.10.1.2-r.0.1.503963.nupkg
     • mcc.xm.upgrade.10.1.2-r.0.1.503963.nupkg
   • Sitecore 10.1.3:
     • mcc.xp.upgrade.10.1.3-r.0.1.503964.nupkg
     • mcc.xm.upgrade.10.1.3-r.0.1.503964.nupkg
   • Sitecore 10.2.0:
     • mcc.xp.upgrade.10.2.0-r.0.1.503965.nupkg
     • mcc.xm.upgrade.10.2.0-r.0.1.503965.nupkg
   • Sitecore 10.2.1:
     • mcc.xp.upgrade.10.2.1-r.0.1.503966.nupkg
     • mcc.xm.upgrade.10.2.1-r.0.1.503966.nupkg
   • Sitecore 10.2.2:
     • mcc.xp.upgrade.10.2.2-r.0.1.503967.nupkg
     • mcc.xm.upgrade.10.2.2-r.0.1.503967.nupkg
   • Sitecore 10.3.0:
     • mcc.xp.upgrade.10.3.0-r.0.1.503969.nupkg
     • mcc.xm.upgrade.10.3.0-r.0.1.503969.nupkg
   • Sitecore 10.3.1:
     • mcc.xp.upgrade.10.3.1-r.0.1.503970.nupkg
     • mcc.xm.upgrade.10.3.1-r.0.1.503970.nupkg
   • Sitecore 10.3.2:
     • mcc.xp.upgrade.10.3.2-r.0.1.503971.nupkg
     • mcc.xm.upgrade.10.3.2-r.0.1.503971.nupkg
   • Sitecore 10.4.0:
     • mcc.xp.upgrade.10.4.0-r.0.1.503972.nupkg
     • mcc.xm.upgrade.10.4.0-r.0.1.503972.nupkg
       
       
2. Install the upgrade package to your solution (follow the guidelines for Sitecore 10.1, Sitecore 10.2, Sitecore 10.3 or Sitecore 10.4)
3. After merging changes to Infrastructure repo, proceed as follows:
   • If the environment does not have DR installed, run the Infrastructure pipeline.
   • If the environment uses DR Managed Hot, run the Infrastructure pipeline with Synchronize primary to secondary checked.
   • If the environment uses DR Basic Cold Standby, run the Infrastructure pipeline with Update outage app checked.
4. After merging changes to Application repo, run the Application pipeline.
5. Run the check cluster upgrades pipeline.
6. Run the cluster version upgrade pipeline (Kubernetes_version 1.31.2 - select the latest available patch version received from the pipeline in the previous step).
7. If the environment uses DR Managed Hot, run the dr cluster version upgrade pipeline (Kubernetes_version 1.31.2 - select the latest available patch version received from the pipeline in step 4).