A Jenkins plugin to deploy VM images to Azure Virtual Machine Scale Sets (VMSS).
You can install/update this plugin in Jenkins update center (Manage Jenkins -> Manage Plugins, search Azure Virtual Machine Scale Set Plugin).
You can also manually install the plugin if you want to try the latest feature before it's officially released. To manually install the plugin:
targetfolder of your repo, click Upload.
To use this plugin to deploy an VM image, first you need to have an Azure Service Principal in your Jenkins instance.
If you haven't created a virtual machine scale set, you can create one in Azure Portal or through Azure CLI.
You should also provide an VM image for deploy. For custom images, you can use tool such as Packer to simplify your work.
Usually you can organize your deploy process into two steps:
Update Scale Sets
This step updates image setting for specific Virtual Machine Scale Sets. Once finished, newly created virtual machines will be provisioned with the new image. Currently running machines are not affected.
This step updates specific instances using the latest image setting of the scale sets. Instances will be stopped and re-created with the new image.
You can also use this plugin in pipeline (Jenkinsfile). Here are some samples to use the plugin in pipeline script:
To update scale sets:
// Update with official image azureVMSSUpdate azureCredentialsId: '<credential_id>', resourceGroup: '<resource_group_name>', name: '<name>', imageReference: [offer: 'UbuntuServer', publisher: 'Canonical', sku: '16.04-LTS', version: 'latest'] // Update with custom image azureVMSSUpdate azureCredentialsId: '<credential_id>', resourceGroup: '<resource_group_name>', name: '<name>', imageReference: [id: '/subscriptions/<subscription>/resourceGroups/<resource_group_name>/providers/Microsoft.Compute/images/<image_name>']
To update instances:
azureVMSSUpdateInstances azureCredentialsId: '<credential_id>', resourceGroup: '<resource_group_name>', name: '<name>', instanceIds: '1,2,3'
For advanced options, you can use Jenkins Pipeline Syntax tool to generate a sample script.
Azure Virtual Machine Scale Set Plugin collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more.
You can turn off usage data collection in Manage Jenkins -> Configure System -> Azure -> Help make Azure Jenkins plugins better by sending anonymous usage statistics to Azure Application Insights.