Updating an Appveyor Azure Image
Electron CI on Windows uses AppVeyor, which in turn uses Azure VM images to run. Occasionally, these VM images need to be updated due to changes in Chromium requirements. In order to update you will need PowerShell and the Azure PowerShell module.
Occasionally we need to update these images owing to changes in Chromium or other miscellaneous build requirement changes.
Example Use Case:
* We need `VS15.9` and we have `VS15.7` installed; this would require us to update an Azure image.
Identify the image you wish to modify.
- In appveyor.yml, the image is identified by the property image.
- The names used correspond to the "images" defined for a build cloud, eg the libcc-20 cloud.
- Find the image you wish to modify in the build cloud and make note of the VHD Blob Path for that image, which is the value for that corresponding key.
- You will need this URI path to copy into a new image.
- You will also need the storage account name which is labeled in AppVeyor as the Disk Storage Account Name
Get the Azure storage account key
- Log into Azure using credentials stored in LastPass (under Azure Enterprise) and then find the storage account corresponding to the name found in AppVeyor.
- Example, for
appveyorlibccbuilds Disk Storage Account Name you'd look for
appveyorlibccbuilds in the list of storage accounts @ Home < Storage Accounts
- Click into it and look for
Access Keys, and then you can use any of the keys present in the list.
Get the full virtual machine image URI from Azure
- Navigate to Home < Storage Accounts <
$ACCT_NAME < Blobs < Images
- In the following list, look for the VHD path name you got from Appveyor and then click on it.
- Copy the whole URL from the top of the subsequent window.
Copy the image using the Copy Master Image PowerShell script.
- It is essential to copy the VM because if you spin up a VM against an image that image cannot at the same time be used by AppVeyor.
- Use the storage account name, key, and URI obtained from Azure to run this script.
- See Step 3 for URI & when prompted, press enter to use same storage account as destination.
- Use default destination container name
- Also, when naming the copy, use a name that indicates what the new image will contain (if that has changed) and date stamp.
- Go into Azure and get the URI for the newly created image as described in a previous step
Spin up a new VM using the Create Master VM from VHD PowerShell.
- From PowerShell, execute
ps1 file with
- You will need the credential information available in the AppVeyor build cloud definition.
- This includes:
- Client ID
- Client Secret
- Tenant ID
- Subscription ID
- Resource Group
- Virtual Network
- You will also need to specify
- Master VM name - just a unique name to identify the temporary VM
- Master VM size - use
- Master VHD URI - use URI obtained @ end of previous step
- Location use
Log back into Azure and find the VM you just created in Home < Virtual Machines <
- You can download a RDP (Remote Desktop) file to access the VM.
Using Microsoft Remote Desktop, click
Connect to connect to the VM.
- Credentials for logging into the VM are found in LastPass under the
AppVeyor Enterprise master VM credentials.
Modify the VM as required.
Shut down the VM and then delete it in Azure.
Add the new image to the Appveyor Cloud settings or modify an existing image to point to the new VHD.