Skip navigation

Zero-downtime Deployment to AKS with Jenkins

Last updated: 06/02/2018

This template allows you to do zero-downtime deployment to AKS Kubernetes cluster with Jenkins. It deploys an instance of Jenkins on a Linux Ubuntu 16.04 LTS VM and an Azure Kubernetes Service (AKS). The Jenkins instance will configured with jobs to deploy Tomcat container to the AKS Kubernetes in RollingUpdate or blue/green strategy without downtime.

This Azure Resource Manager (ARM) template was created by a member of the community and not by Microsoft. Each ARM template is licensed to you under a licence agreement by its owner, not Microsoft. Microsoft is not responsible for ARM templates provided and licensed by community members and does not screen for security, compatibility or performance. Community ARM templates are not supported under any Microsoft support programme or service, and are made available AS IS without warranty of any kind.

Parameters

Parameter Name Description
adminUsername User name for the Virtual Machine.
sshPublicKey Configure all linux machines with the SSH public key string, for example 'ssh-rsa AAAAB...snip...UcyupgH azureuser@linuxvm'
virtualMachineSize The virutal machine size to use. We picked out the sizes with 2 vCPUs, but in real world projects you can choose other sizes as you desired.
kubernetesVersion The version of the Kubernetes running in AKS.
jenkinsDnsPrefix Unique DNS Name prefix for the Public IP used to access the Jenkins Virtual Machine. Azure will form the final DNS name as '<prefix>.<region>.cloudapp.azure.com'.
servicePrincipalAppId Service Principal App ID (also called Client ID) that has contributor rights to the subscription used for this deployment. It is used by the Kubernetes cluster to dynamically manage resources (e.g. user-defined load balancers).
servicePrincipalAppKey Service Principal App Key (also called Client Secret) that has contributor rights to the subscription used for this deployment. It is used by the Kubernetes cluster to dynamically manage resources (e.g. user-defined load balancers).
location Location for all resources.

Use the template

PowerShell

New-AzureRmResourceGroupDeployment -Name <deployment-name> -ResourceGroupName <resource-group-name> -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/301-jenkins-aks-zero-downtime-deployment/azuredeploy.json
Installing and configuring Azure PowerShell

Command line

azure config mode arm
azure group deployment create <my-resource-group> <my-deployment-name> --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/301-jenkins-aks-zero-downtime-deployment/azuredeploy.json
Installing and configuring the Azure cross-platform command-line interface