Creating and Uploading a Virtual Hard Disk that Contains the Linux Operating System
Azure has two different deployment models for creating and working with resources: Resource Manager and classic. This article covers using the classic deployment model. Microsoft recommends that most new deployments use the Resource Manager model. You can also upload a custom disk image using Azure Resource Manager.
This article shows you how to create and upload a virtual hard disk (VHD) so you can use it as your own image to create virtual machines in Azure. Learn how to prepare the operating system so you can use it to create multiple virtual machines based on that image.
If you have a few moments, please help us to improve the Azure Linux VM documentation by taking this quick survey of your experiences. Every answer helps us help you get your work done.
This article assumes that you have the following items:
- Linux operating system installed in a .vhd file - You have installed an Azure-endorsed Linux distribution (or see information for non-endorsed distributions) to a virtual disk in the VHD format. Multiple tools exist to create a VM and VHD:
The newer VHDX format is not supported in Azure. When you create a VM, specify VHD as the format. If needed, you can convert VHDX disks to VHD using
qemu-img convert or the
Convert-VHD PowerShell cmdlet. Further, Azure does not support uploading dynamic VHDs, so you need to convert such disks to static VHDs before uploading. You can use tools such as Azure VHD Utilities for GO to convert dynamic disks during the process of uploading to Azure.
- Azure Command-line Interface - Install the latest Azure Command-Line Interface to upload the VHD.
Azure supports various Linux distributions (see Endorsed Distributions). The following articles guide you through how to prepare the various Linux distributions that are supported on Azure. After you complete the steps in the following guides, come back here once you have a VHD file that is ready to upload to Azure:
- CentOS-based Distributions
- Debian Linux
- Oracle Linux
- Red Hat Enterprise Linux
- SLES & openSUSE
- Other - Non-Endorsed Distributions
The Azure platform SLA applies to virtual machines running the Linux OS only when one of the endorsed distributions is used with the configuration details as specified under 'Supported Versions' in Linux on Azure-Endorsed Distributions. All Linux distributions in the Azure image gallery are endorsed distributions with the required configuration.
Also see the Linux Installation Notes for more general tips on preparing Linux images for Azure.
Make sure you are using the Azure CLI in the classic deployment model (
azure config mode asm), then log in to your account:
You need a storage account to upload your VHD file to. You can either pick an existing storage account or create a new one.
Use the Azure CLI to upload the image by using the following command:
azure vm image create <ImageName> ` --blob-url <BlobStorageURL>/<YourImagesFolder>/<VHDName> ` --os Linux <PathToVHDFile>
In the previous example:
- BlobStorageURL is the URL for the storage account you plan to use
- YourImagesFolder is the container within blob storage where you want to store your images
- VHDName is the label that appears in portal to identify the virtual hard disk.
- PathToVHDFile is the full path and name of the .vhd file on your machine.
The following shows a complete example:
azure vm image create UbuntuLTS ` --blob-url https://teststorage.blob.core.windows.net/vhds/UbuntuLTS.vhd ` --os Linux /home/ahmet/UbuntuLTS.vhd
You create a VM using
azure vm create in the same way as a regular VM. Specify the name you gave your image in the previous step. In the following example, we use the UbuntuLTS image name given in the previous step:
azure vm create --userName ops --password P@ssw0rd! --vm-size Small --ssh ` --location "West US" "DeployedUbuntu" UbuntuLTS
To create your own VMs, provide your own username + password, location, DNS name, and image name.
For more information, see Azure CLI reference for the Azure classic deployment model.