Add Linux images to Azure Stack
Applies to: Azure Stack integrated systems and Azure Stack Development Kit
You can deploy Linux virtual machines (VMs) on Azure Stack by adding a Linux-based image into the Azure Stack Marketplace. The easiest way to add a Linux image to Azure Stack is through Marketplace Management. These images have been prepared and tested for compatibility with Azure Stack.
To download Linux images from the Azure Marketplace, use the procedures in the following article. Select the Linux images that you want to offer users on your Azure Stack.
Prepare your own image
You can prepare your own Linux image using one of the following instructions:
Download and install the Azure Linux Agent.
The Azure Linux Agent version 2.2.2 or higher is required to provision your Linux VM on Azure Stack and some versions do not work (2.2.12 and 2.2.13, for examples). Many of the distributions listed previously already include a version of the agent (typically called
walinuxagent). If you create a custom image, you must install the agent manually. The installed version can be determined from the package name or by running
/usr/sbin/waagent -versionon the VM.
Follow the instructions below to install the Azure Linux agent manually -
a. First, download the latest Azure Linux agent from GitHub, example:
# wget https://github.com/Azure/WALinuxAgent/archive/v2.2.21.tar.gz
b. Unpack the Azure agent:
# tar -vzxf v2.2.21.tar.gz
c. Install python-setuptools
**Debian / Ubuntu** # sudo apt-get update # sudo apt-get install python-setuptools **Ubuntu 16.04+** # sudo apt-get install python3-setuptools **RHEL / CentOS / Oracle Linux** # sudo yum install python-setuptools
d. Install the Azure agent:
# cd WALinuxAgent-2.2.21 # sudo python3 setup.py install --register-service
Systems with Python 2.x and Python 3.x installed side-by-side may need to run the following command:
sudo python3 setup.py install --register-service
For more information, see the Azure Linux Agent README.
- Add the image to the Marketplace. Make sure that the
OSTypeparameter is set to
- After you've added the image to the Marketplace, a Marketplace item is created and users can deploy a Linux virtual machine.