Uploading your own image
Find out how to upload your own image to Public Cloud
Last updated 27th October 2020
Objective
OVHcloud offers ready-to-go images for Public Cloud instances, however we also enable customers to use their own images.
This guide will provide the steps to upload your own images to your project.
Requirements
- A Public Cloud instance in your OVHcloud account
- Your own RAW/QCOW2 (recommended formats) image
- An OpenStack user
- An OpenStack CLI ready environment (if using CLI)
Instructions
Before starting
It is advisable to either use cloud-ready images already provided by the distribution vendor or build your own image using solutions such as Packer OpenStack builder.
Cloud-ready images can be found here:
- https://cloud.centos.org/centos/
- https://cloud.debian.org/images/cloud/
- https://cloud-images.ubuntu.com/releases/
- https://alt.fedoraproject.org/cloud/
Other operating systems tend to offer ISO images which are also applicable when building images with Packer such as QEMU and VirtualBox builders.
We recommend ensuring the following is installed on your images for them to be cloud-ready:
- QEMU Guest Agent: this will provide better snapshot experience as it will allow the host to communicate to the instance for live snapshots. Not all operating systems are compatible with this package but most of them are.
- cloud-init: this will allow you to bootstrap your instance on the first boot, such as adding SSH keys and configuring network. Most operating systems are compatible with this.
Finally we recommend images to be either in RAW or QCOW2 format. As best practice, keep the size of the image as small as possible so that you are billed less per month and spawns of your instances are quicker.
Uploading your image
With OpenStack there are two ways of uploading your own image. You can either upload it via the OpenStack command line interface or with the Horizon web interface.
Using CLI
Once your image is ready to upload, you can use the following steps to upload it using the OpenStack CLI:
1. Download your openrc.sh file for your OpenStack user from the OVHcloud Control Panel (select the region you want to upload to).
2. Source the openrc file:
source openrc.sh
3. Once the file is sourced, you will be asked to enter the password for the OpenStack user. Enter your password.
4. Now you can upload your image. This example command will do the following:
- Disk format is "RAW"
- Upload an image from the current path called "debian9.raw"
- Call the image "Debian 9 - My Image"
- Set the image to private state
- Set properties which are recommended to set. Set optimal configuration which allow features like live-snapshot and cloud-init to work (requires the username to be used)
openstack image create --disk-format raw --container-format bare --file debian9.raw "Debian 9 - My Image" --private --property distribution=debian --property hw_disk_bus=scsi --property hw_scsi_model=virtio-scsi --property hw_qemu_guest_agent=yes --property image_original_user=debian
Using Horizon
Once your image is ready to upload, you can use the following steps to upload it using the OpenStack Horizon web interface:
1. Log in to the Horizon interface.
2. Select on the top left the region to which you want to upload your image.
3. Go to the Images section and click on Create Image.
4. Enter the details of your image and select the file from your computer.
5. Enter the instance metadata (any custom ones you may have you can also add) and then click Create Image.
Go further
Join our community of users on https://community.ovh.com/en/.
Did you find this guide useful?
Please feel free to give any suggestions in order to improve this documentation.
Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.
Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.
Thank you. Your feedback has been received.