How to upgrade Sitecore Managed Cloud Containers solutions to AKS 1.24


Description

The end of life of Azure Kubernetes Service (AKS) 1.23 is March 2023. Sitecore Managed Cloud Containers solutions, based on AKS 1.23, must be updated to a newer version that uses AKS 1.24. For more details on AKS end of life and the consequences of deprecation see here.

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

Note: Upgrade your solution only if the version you have is earlier than the ones listed below in the Solution section. To find out the version of your solution, view the solution.json file in the infrastructure repository of your Sitecore Managed Cloud Containers Azure DevOps project. If your environment is still running on AKS 1.22, it is recommended first to upgrade to AKS 1.23 and then follow the steps in this article.

Breaking Changes

Upgrading from AKS version 1.23 to 1.24 introduces no breaking changes to a standard installation of Sitecore Managed Cloud.

Upgrade Instructions

  1. Download an upgrade package for the required 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.287527.nupkg
      • mcc.xm.upgrade.10.1.0-r.0.1.287527.nupkg
      • mcc.xc.upgrade.10.1.0-r.0.1.287527.nupkg
    • Sitecore 10.1.1:
      • mcc.xp.upgrade.10.1.1-r.0.1.287525.nupkg
      • mcc.xm.upgrade.10.1.1-r.0.1.287525.nupkg
    • Sitecore 10.1.2:
      • mcc.xp.upgrade.10.1.2-r.0.1.287524.nupkg
      • mcc.xm.upgrade.10.1.2-r.0.1.287524.nupkg
    • Sitecore 10.2.0:
      • mcc.xp.upgrade.10.2.0-r.0.1.287520.nupkg
      • mcc.xm.upgrade.10.2.0-r.0.1.287520.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.24 - select the latest available patch version received from the pipeline in step 5).