How to install the appliance on Azure¶
The Anbox Cloud Appliance is not yet available from the Azure Marketplace. However, you can install the Anbox Cloud Appliance snap on an Azure machine.
Deploy using a quickstart template¶
An Azure quickstart template is available for deploying the Anbox Cloud Appliance on Azure. The template automatically deploys and configures the necessary settings for the Anbox Cloud Appliance.
Once you have completed the deployment steps, finish the installation by performing the following steps:
Register your Ubuntu SSO account with the appliance dashboard.
Tip
The output from the template will contain the public IP address of the VM that is required to complete this step.
Deploy manually¶
An alternate option to using the quickstart template is to deploy manually. If you wish to deploy Anbox Cloud Appliance manually on Azure, the following instructions guide you through all relevant steps.
Click for details
The entire deployment process will take 20-30 minutes, depending on the selected hardware and the network conditions.
Prerequisites¶
Check the hardware requirements listed in Requirements for the Anbox Cloud Appliance.
In addition, make sure you have the following prerequisites:
An Ubuntu SSO account. If you don’t have one yet, create it here.
Your Ubuntu Pro token for an Ubuntu Pro subscription. If you don’t have one yet, speak to your Canonical representative. If you already have a valid Ubuntu Pro token, log in to Ubuntu Pro to retrieve it.
Caution
The Ubuntu Pro (Infra-only) token does NOT work and will result in a failed deployment. You need an Ubuntu Pro subscription.
An Azure account that you use to create the virtual machine.
Once you have the prerequisites, the first step is to create a virtual machine on which you can install the Anbox Cloud Appliance.
Create a Linux virtual machine¶
Log on to the Microsoft Azure Portal and select the Quickstart Center service.
In the Quickstart Center, select Deploy a virtual machine. On the resulting screen, select Create a Linux virtual machine.
Configure basic settings¶
On the Basics tab of the virtual machine configuration, specify the required information. Several of the options are specific to how and where you want to deploy your virtual machine. In most cases you can keep the default values, but make sure to set the following configurations:
Select the latest Ubuntu image (Ubuntu Server 22.04 LTS) for the architecture that you want to use. The following instructions and screenshots use the Arm64 architecture.
Select a size that matches the hardware requirements(see Minimum hardware requirements). For example, select
Standard_D16ps_v5, which has 16 vCPUs and 64 GB of RAM.Change the user name of the administrator account to
ubuntu.Accept the defaults for the inbound port rules for now; these rules will be configured later in the setup process.
Click Next: Disks to continue to the next tab.
Configure disks¶
Azure separates the main disk for the operating system and any data disks. On the Disks tab of the virtual machine configuration, you can configure the OS disk and attach data disks.
For the Anbox Cloud Appliance, you should attach a separate data disk of at least 50 GB. To do so, click Create and attach a new disk. You can accept the default settings and change the disk size according to your requirements. For performance reasons, we recommend using 100 GB or more.
Click Next: Networking to continue to the next tab.
Configure networking¶
For networking, the Anbox Cloud Appliance requires the following change to the default settings:
For the NIC network security group, select Advanced and create a network security group.
Add an inbound security rule that allows access to the following destination port ranges:
80,443,8444,5349,10000-11000,60000-60100Change the name of the rule and, if relevant for your setup, adapt the priority of the rule.
Finalise the configuration¶
Check the configuration settings on the remaining tabs and make sure they are suitable for your deployment. The Anbox Cloud Appliance does not require any changes to the default configuration for these areas.
Review and create¶
On the Review + create tab, check the final configuration. If everything looks good, click Create to launch the virtual machine.
Azure will prompt you to download your private key before it starts creating the virtual machine. Make sure to save the private key in a secure location and with secure permissions (0600).
When deployment is complete, you can log on to the machine and install the Anbox Cloud Appliance.
For additional information, see the Microsoft documentation about creating virtual machines in Azure.
Connect to the VM¶
To install the Anbox Cloud Appliance, you must connect to the virtual machine that you just created, using SSH.
To do so, go to the resource page of your virtual machine and find its public IP address. Then use SSH to log on to the machine, using the user name ubuntu and the private key file that you downloaded during the creation of the virtual machine. For example:
ssh -i Downloads/anbox-cloud-appliance_key.pem [email protected]
Finish the installation¶
Finally, install the Anbox Cloud Appliance on the virtual machine by following the instructions in Install the appliance on a dedicated machine. Remember to follow all the steps in order to have a successful installation.
When you are done, you can log into the appliance dashboard using https://your-machine-address with your Ubuntu SSO account.