The Managed Cloud Standard pipelines
Each Sitecore Managed Cloud client has the following pipelines to control their solution: Application
, Infrastructure
, Frontdoor
, Pod restart
, Node restart
, Windows node upgrade
, Sitecore license update
, Cluster upgrades
, Cluster version upgrades
, update alertmanager email notification
and Unlock Terraform state
. You can modify the existing pipelines or add your own.
Application
You use the Application
pipeline to deliver application code. It deploys Ansible scripts to set up the Azure Kubernetes Service (AKS) pods containing each running container. You must use the Application repository to customize your Sitecore solution and to customize your Managed Cloud instance. You must build customized containers with your application elements, upload them to the Azure Container Registry (ACR), and change references to use your new customized images..
You can trigger the pipeline automatically and manually.
Infrastructure
You use the Infrastructure
pipeline to deliver infrastructure code. It deploys Terraform scripts to read the configuration and synchronize all elements of the deployment to match the settings in the configuration files. After the pipeline has run successfully, the Infrastructure Terraform state file is stored in an Azure Storage account.
You can trigger the pipeline automatically and manually.
Frontdoor
You use the Frontdoor
pipeline to deploy Terraform scripts to read the configuration and synchronize all elements of the deployment to match the settings in the configuration files. When the pipeline has run successfully, the Frontdoor Terraform state file is stored in an Azure Storage account. After the Frontdoor configuration is updated, you must trigger the Frontdoor pipeline manually .
Restart Sitecore deployments
You use the restart Sitecore deployments
pipeline to restart a Sitecore solution without downtime. For example, you can use it to get your app working again if your container reports an error and the Kubernetes (k8s) can not handle it.
To restart a specific deployment, run the pipeline and choose the target deployment:
Reboot node
You use the reboot node
pipeline to restart Kubernetes nodes, for example, to complete an operating system update. The pipeline has two options: restart Windows or/and Linux node types.
You can choose the type of scale set to restart (Windows or Linux) and trigger a pipeline.
All nodes for a target node type are restarted simultaneously and you must expect downtime for about 5 minutes.
If you extended your solution with a Kubernetes deployment (for a Sitecore module or another service), the Node reboot
pipeline may fail because of a Kubernetes deployment restart timeout. To mitigate this issue, you must extend the progressDeadlineSeconds
value.
Windows node upgrade
You use the Windows node upgrade
pipeline to upgrade the AKS Windows node pool OS image. For more information, see the Microsoft Azure documentation. You can check upgrade availability using Azure CLI.
Update Sitecore license
You use the update Sitecore license
pipeline to upgrade the Sitecore license for the existing deployment. To update the license, you must copy the Sitecore license content and paste it into the Azure devops parameter field while running the pipeline. The license is updated without downtime.
Cluster upgrades
It is important to regularly use the Cluster upgrades
pipeline to check which Kubernetes releases are available for your cluster. This makes sure that you have the latest version of AKS including latest patches and bug fixes. For more information, please refer to the Microsoft documentation.
The Cluster upgrades
pipeline checks updates that are available for your current minor AKS version within your location.
Cluster version upgrade
You use the Cluster version upgrade
pipeline to upgrade the AKS cluster. This pipeline runs with no downtime.
This topic assumes you have permission to run the DevOps cluster version upgrade pipeline.
The pipeline upgrades the following to the newer versions:
-
The control panel
-
The Linux node pool
-
The Windows node pool
If the pipeline fails, contact Sitecore Support to resolve the issue.
To upgrade from 1.22 to 1.23. follow instruction in the Knowledge Base article: How to upgrade Sitecore Managed Cloud Containers solutions to AKS 1.23.
Update alertmanager email notification
You use the update alertmanager email notification
pipeline to configuring email notifications for a custom set of recipients in the alertmanager.
To configure email notifications:
-
Open the
update alertmanager email notification
pipeline and fill required parameters: -
Enable or disable email notifications.
-
Enter the SMTP server host and port to use for sending emails.
-
Enter the user name of the SMTP server.
-
Enter the password for the SMTP server.
-
Enter the email address of the sender.
-
Enable or disable TLS for sending emails.
-
Enter a comma-separated list of the email addresses that the notifications from the alertmanager should be sent to.
When the pipeline has finished, run the application
pipeline.
When the application
pipeline is finished, run the following command to restart the alertmanager deployment:
kubectl rollout restart deployment alertmanager -n monitoring
Unlock Terraform state
You use the unlock terraform state
pipeline to unlock terraform state for Infrastructure or Frontdoor.