Skip to main content

Download and create an image

Last update:

You can download images to the Selectel image repository:

You can create a disk image from any local or network disk on the cloud server.
The disk can be either a boot disk or an optional disk.

This is the kind of image you can use:

  • to quickly configure identical cloud servers — server cloning.If an operating system and software are installed on a server, you can deploy already configured servers from the boot disk image.This is faster than setting up the desired configuration of multiple servers;
  • to change the type of boot disk;
  • transferring the server to other pools, projects or accounts;
  • cloud server disk export;
  • If the image from which the server was previously created is deleted, you can create an image from the server disk and, if necessary, create the same cloud server.

Limitations

When uploading an image to the Selectel Image Store from a file and link, the image size must be less than 2048 GB (2 TB).

If you need to download an image from a larger file, download it via S3.

You can create an image from a disk size less than 2048 GB (2 TB).

Load an image from a file

You can load an image from a file of a certain size from your local computer into the Selectel image repository. See the Limitations subsection for more information on image size limitations.

  1. In the Dashboard, on the top menu, click Products and select Cloud Servers.

  2. Go to the Images section.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  6. Select the operating system.

  7. Select a file as the image source.

  8. Click Download.

  9. Select an image format or container format.For more information about formats, see Own Images.

    If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

    If you don't know what formats to specify, specify raw image format, bare container format.

  10. Optional: check the box Specify minimum disk and memory size and specify the RAM size in MB and disk size in GB.This is the minimum disk and RAM size with which you can create a server from this image.You cannot specify minimum values for .iso images.

    Once the image is created, you cannot change the minimum disk and memory sizes in the control panel. To change the minimum values, you will need to recreate the image or use the OpenStack CLI.

  11. Click Create.

You can upload an image to the Selectel image repository via a public link to a file of a certain size containing the image.See the Limitations subsection for more information on image size limits.

  1. In the dashboard, on the top menu, click Products and select Cloud Servers.

  2. Go to the Images section.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  6. Select the operating system.

  7. Select the URL as the source of the image.

  8. Enter a link to the image file in the format https://example.com/file.raw.

  9. Select an image format or container format.For more information about formats, see Own Images.

    If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

    If you don't know what formats to specify, specify raw image format, bare container format.

  10. Optional: check the box Specify minimum disk and memory size and specify the RAM size in MB and disk size in GB.This is the minimum disk and RAM size with which you can create a server from this image.You cannot specify minimum values for .iso images.

    Once the image is created, you cannot change the minimum disk and memory sizes in the control panel. To change the minimum values, you will need to recreate the image or use the OpenStack CLI.

  11. Click Create.

Download image via S3

  1. Upload the image to S3 via segmented boot.

  2. Obtain an IAM token for the project (X-Auth-Token).

  3. In the query output, copy the value in the X-Subject-Token field.

  4. Open the CLI on the local computer.

  5. Create an image through the API:

    curl 'https://<pool>.cloud.api.selcloud.ru/image/v2/images' \
      -H 'X-Auth-Token: <x_auth_token>' \
      -H 'Content-Type: application/json;charset=utf-8' \
      --data '{"name":"<image_name>","disk_format":"<image_format>","container_format":"<container_format>"}'

    Specify:

    • <pool> — pool to which the image will be loaded, for example ru-1 URL depends on the region and pool, you can look in the URL list.The list of available pools can be viewed in the table Selectel Infrastructure;

    • <x_auth_token> — The IAM token for the project you copied in step 3;

    • <image_name> — image name;

    • <image_format> — image format.For more information about image formats, see the subsection Own images.If you don't know what format to specify, specify raw;

    • <container_format> — container format.More information about container formats in the subsection Own images.

      If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

      If you don't know which format to specify, specify bare.

  6. In the query output, copy the value in the id field.

  7. Get a link to the image in S3.

  8. Upload the image to the image repository:

    curl 'https://<pool>.cloud.api.selcloud.ru/image/v2/images/<image_id>/import' \
      -X POST \
      -H 'Content-Type: application/octet-stream' \
      -H 'X-Image-Meta-Store: <pool_segment>' \
      -H 'X-Auth-Token: <x_auth_token>' \
      --data-raw '{"method":{"name":"web-download","uri":"<object_storage_url>"}}'

    Specify:

    • <pool> — pool to which the image will be loaded, for example ru-1 URL depends on the region and pool, you can look in the URL list.The list of available pools can be viewed in the table Selectel Infrastructure;
    • <image_id> — The ID of the image you copied in step 6;
    • <pool_segment> — pool segment into which the image will be loaded, e.g. ru-1a The list of available pool segments can be viewed in the table below. Selectel Infrastructure;
    • <x_auth_token> — The IAM token you copied in step 3;
    • <object_storage_url> — image link in S3 of the form https://<uuid>.selstorage.ru/container_name/object_name which you obtained in step 7.

Download the vmdk from a file or from a link

See the Restrictions subsection for more information on image size limitations.

  1. Export a virtual machine from VMware in .ovf format.For more information, see the Export an ovf Template instructions in the VMware documentation.

    If the virtual disk type is MONOLITHIC_SPARSE or MONOLITHIC_FLAT, you can skip this step, but we recommend exporting the VM in .ovf format.

  2. In the dashboard, on the top menu, click Products and select Cloud Servers.

  3. Go to the Images section.

  4. Click Create Image.

  5. Enter a name for the image.

  6. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  7. Select the operating system.

  8. Select a file or URL as the image source.

  9. If you selected a file, click Upload. If you selected URL, enter a link to the image file in https://example.com/file.raw format.

  10. Select the format of the image:

    • vmdk — if the virtual machine was exported from VMware in the format .ovf or you are booting a virtual disk with a type of MONOLITHIC_SPARSE;
    • raw — if you boot a virtual disk with the type MONOLITHIC_FLAT.

  11. Select the container format:

    • ovf — if the virtual machine was exported from VMware in the format .ovf;
    • bare metal — if you boot a virtual disk with the type MONOLITHIC_SPARSE or MONOLITHIC_FLAT.

  12. Optional: check the box Specify minimum disk and memory size and specify the RAM size in MB and disk size in GB.This is the minimum disk and RAM size with which you can create a server from this image.You cannot specify minimum values for .iso images.

    Once the image is created, you cannot change the minimum disk and memory sizes in the control panel. To change the minimum values, you will need to recreate the image or use the OpenStack CLI.

  13. Click Create.

Create an image from a disk

Look at the limits on the size of the disk from which you can create an image.

The process of creating an image depends on the type of disk.

  1. If the disk is connected to a cloud server, we recommend shutting down the cloud server — a non-consistent image may be created from a running disk.

  2. In the Dashboard, on the top menu, click Products and select Cloud Servers.

  3. Go to the Servers section.

  4. From the server's menu, select Create Local Disk Image.

  5. Enter a name for the image.

  6. Optional: check the box Specify minimum disk and memory size and specify the RAM size in MB and disk size in GB.This is the minimum disk and RAM size with which you can create a server from this image.You cannot specify minimum values for .iso images.

  7. Click Create.