The Bring Your Own Image technology (BYOI) enables you to deploy cloud ready images directly on your Dedicated Server. You can use this service to deploy your own operating systems.
Be aware that there are some technical limitations linked to the use of physical products such as Dedicated Servers. Here is a non-exhaustive list to keep in mind during your deployment preparation:
- Boot type: uefi or legacy
- Partition type: MBR or GPT
- Image format: qcow2 or raw
If your server has a uefi boot type, be sure to add an EFI partition to your image template.
Deploying an Image
To start, log into the OVHcloud API. Navigate to the
/dedicated/server section. You can use the "Filter" field to look for "BringYourOwnImage." The BYOI feature uses 3 API calls.
To deploy your image, use the following API call and complete the required fields:
The ConfigDrive partitions is used by cloud-init when the server first boots in order to configure it with your needs. You can choose whether you enable it or not.
Checking a Deployment
You can track the deployment of your image through the API call below or through the KVM/IPMI.
In this example, the deployment is starting.
Deleting a Deployment
You can choose to remove your deployment by using the following API call:
This will erase the deployment status and put your server in Rescue Mode.
Having read this article, you should be able to use the Bring Your Own Image feature for your Dedicated Servers in the OVHcloud API.