The end of life of Azure Kubernetes Service (AKS) 1.22 is November 2022. Sitecore Managed Cloud Containers solutions, based on AKS 1.22, must be updated to a newer version that uses AKS 1.23. For more details on AKS's end of life and the consequences of deprecation refer to here.
Upgrade your solution only if the version you have is lower than the ones listed below in 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.23.
Upgrading the AKS version from 1.22 to 1.23 introduces some breaking changes:
Image entry point override can be accomplished via k8s pod container specification using additional cmd and args added as shown below. For example:
apiVersion: batch/v1
kind: Job
metadata:
name: custom-mssql-init
spec:
template:
spec:
containers:
- name: custom-mssql-init
image: '<the appropriate mssql-init image goes here>'
command: ["powershell.exe"]
args: [
".\\StartInit.ps1",
"-ResourcesDirectory", "$env:RESOURCES_PATH",
"-SqlServer", "$env:SQL_SERVER",
"-SqlAdminUser", "$env:SQL_ADMIN_LOGIN",
"-SqlAdminPassword", "$env:SQL_ADMIN_PASSWORD",
"-SitecoreAdminPassword", "$env:sitecore_admin_password",
"-SqlElasticPoolName", "$env:SQL_ELASTIC_POOL_NAME",
"-DatabasesToDeploy", "$env:DATABASES_TO_DEPLOY",
"-DatabaseUsers", "@(@{'databaseName' = 'Sitecore.Master'; 'username' = $env:Master_Database_Username; 'password' = $env:Master_Database_Password},@{'databaseName' = 'Sitecore.Core'; 'username' = $env:Core_Database_Username; 'password' = $env:Core_Database_Password},@{'databaseName' = 'Sitecore.Web'; 'username' = $env:Web_Database_Username; 'password' = $env:Web_Database_Password},@{'databaseName' = 'Sitecore.Experienceforms'; 'username' = $env:Forms_Database_Username; 'password' = $env:Forms_Database_Password},@{'databaseName' = 'Sitecore.Exm.master'; 'username' = $env:Exm_Master_Database_Username; 'password' = $env:Exm_Master_Database_Password},@{'databaseName' = 'Sitecore.Marketingautomation'; 'username' = $env:Marketing_Automation_Database_Username; 'password' = $env:Marketing_Automation_Database_Password},@{'databaseName' = 'Sitecore.Messaging'; 'username' = $env:Messaging_Database_Username; 'password' = $env:Messaging_Database_Password },@{'databaseName' = 'Sitecore.Reporting'; 'username' = $env:Reporting_Database_Username; 'password' = $env:Reporting_Database_Password },@{'databaseName' = 'Sitecore.Referencedata'; 'username' = $env:Reference_Data_Database_Username; 'password' = $env:Reference_Data_Database_Password },@{'databaseName' = 'Sitecore.Processing.Pools'; 'username' = $env:Processing_Pools_Database_Username; 'password' = $env:Processing_Pools_Database_Password },@{'databaseName' = 'Sitecore.Processing.Tasks'; 'username' = $env:Processing_Tasks_Database_Username; 'password' = $env:Processing_Tasks_Database_Password },@{'databaseName' = 'Sitecore.Processing.Engine.Tasks'; 'username' = $env:Processing_Engine_Tasks_Database_Username; 'password' = $env:Processing_Engine_Tasks_Database_Password },@{'databaseName' = 'Sitecore.Processing.Engine.Storage'; 'username' = $env:Processing_Engine_Storage_Database_Username; 'password' = $env:Processing_Engine_Storage_Database_Password },@{'databaseName' = 'Sitecore.Xdb.Collection.ShardMapManager'; 'username' = $env:Collection_ShardMapManager_Database_Username; 'password' = $env:Collection_ShardMapManager_Database_Password },@{'databaseName' = 'Sitecore.Xdb.Collection.Shard0'; 'username' = $env:Collection_ShardMapManager_Database_Username; 'password' = $env:Collection_ShardMapManager_Database_Password },@{'databaseName' = 'Sitecore.Xdb.Collection.Shard1'; 'username' = $env:Collection_ShardMapManager_Database_Username; 'password' = $env:Collection_ShardMapManager_Database_Password })"
]
---
apiVersion: batch/v1
kind: Job
metadata:
name: custom-solr-init
spec:
template:
spec:
initContainers:
- name: wait-solr
image: "{{ docker_images.external.windowsservercore }}"
command: ["pwsh"]
args: ["-Command", "do { Start-Sleep -Seconds 3 } until ((tnc $env:SERVER -port $env:PORT).TcpTestSucceeded)"]
env:
- name: SERVER
value: "{{ solr_fqdn }}"
- name: PORT
value: "{{ solr_port }}"
containers:
- name: custom-solr-init
image: '<the appropriate mssql-init image goes here>'
command: ["powershell.exe"]
args: [
".\\Start.ps1",
"-SitecoreSolrConnectionString", "$env:SITECORE_SOLR_CONNECTION_STRING",
"-SolrCorePrefix", "$env:SOLR_CORE_PREFIX_NAME",
"-SolrSitecoreConfigsetSuffixName", "$env:SOLR_SITECORE_CONFIGSET_SUFFIX_NAME",
"-SolrReplicationFactor", "$env:SOLR_REPLICATION_FACTOR",
"-SolrNumberOfShards", "$env:SOLR_NUMBER_OF_SHARDS",
"-SolrMaxShardsPerNodes", "$env:SOLR_MAX_SHARDS_NUMBER_PER_NODES",
"-SolrXdbSchemaFile", ".\\data\\schema.json",
"-SolrCollectionsToDeploy", "$env:SOLR_COLLECTIONS_TO_DEPLOY"
]
env:
- name: SOLR_COLLECTION_SOURCES
valueFrom: