How to upload your custom image using 3Engines CLI on 3Engines Cloud🔗¶
In this tutorial, you will upload custom image stored on your local computer to 3Engines Cloud cloud, using the 3Engines CLI client. The uploaded image will be available within your project alongside default images from 3Engines Cloud cloud and you will be able to create virtual machines using it.
What We Are Going To Cover🔗¶
- How to check for the presence of the image in your 3Engines cloud
- How different images might behave
- How to upload the image using only CLI commands
- Example: how to upload image for Debian 11
- What happens if you lose Internet connection during upload
Prerequisites🔗¶
No. 1 Account
You need a 3Engines Cloud hosting account with access to the Horizon interface: https://3engine.rootxwire.com/.
No. 2 3Engines CLI configured
You need to have the 3Engines CLI client configured and operational. See How to install 3EnginesClient for Linux on 3Engines Cloud. You can test whether your 3Engines CLI is properly activated by executing the 3Engines server list command mentioned in the end of that article - it should return the list of your virtual machines.
No. 3 Custom image you wish to upload
You need to have the image you wish to upload. It can be one of the following image formats:
aki ami ari iso qcow2 raw vdi vhd vhdx vmdk
The following container formats are supported:
aki ami ari bare docker ova ovf
For the explanation of these formats, see article What Image Formats are Available in 3Engines 3Engines Cloud cloud.
No. 4 Uploaded public SSH key
If the image you wish to upload requires you to attach an SSH public key while creating the virtual machine, the key will need to be uploaded to 3Engines Cloud cloud. One of these articles should help: