Skip to main content
Download and create an image
Last update:

Download and create an image

You can download images to the Selectel image repository:

You can create your own disk image.

Limitations⁠

When uploading an image to the Selectel image repository from a file and from a link, there are image size limitations, depending on the pool. You can download an image of the size:

  • up to 2048 GB (2 TB) — in the ru-2 pool;
  • up to 1024 GB (1 TB) — in other pools.

If you need to load an image from a larger file size, upload it through the object store.

You can create an image from a disk of size:

  • up to 2048 GB (2 TB) — in the ru-2 pool;
  • up to 1024 GB (1 TB) — in other pools.

Load an image from a file⁠

You can download an image to the Selectel image repository from a file on your local computer. Check it out restrictions on the size of the downloaded image.

  1. In control panel go to Cloud platform → Images.

  2. Click Create an image.

  3. Enter a name for the image.

  4. Select pool segment into which the image will be loaded.

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

  5. Select the operating system.

  6. Select a file as the image source.

  7. Click Download.

  8. Select an image format or container format. For more information about formats, see the subsection Own images.

    If you download an archive with the container format .ovaWe recommend unpacking the archive before downloading to make the image work correctly.

    If you do not know which formats to specify, specify the image format rawand the container — bare.

  9. Optional: check the checkbox Specify minimum disk and memory capacity. Specify the minimum amount of RAM in MB and disk capacity in GB. When you create a cloud server from this image, the control panel or API will automatically check these limits.

  10. Click Create.

You can upload an image to the Selectel image repository via a public link to the image file. See restrictions on the size of the downloaded image.

  1. In control panel go to Cloud platform → Images.

  2. Click Create an image.

  3. Enter a name for the image.

  4. Select pool segment into which the image will be loaded.

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

  5. Select the operating system.

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

  7. Enter a link to the image file in the format https://domain.com/file.raw.

  8. Select an image format or container format. For more information about formats, see the subsection Own images.

    If you download an archive with the container format .ovaWe recommend unpacking the archive before downloading to make the image work correctly.

    If you do not know which formats to specify, specify the image format rawand the container — bare.

  9. Optional: check the checkbox Specify the minimum disk and memory capacity. Specify the minimum amount of RAM in MB and disk capacity in GB. When you create a cloud server from this image, the control panel or API will automatically check these limits.

  10. Click Create.

Load image via object storage⁠

  1. Upload the image to the object store through segmented downloading.

  2. Get a Keystone token.

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

  4. Open the CLI on the local computer.

  5. Create a request to create an image:

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

    Specify:

    • <pool> — pool into which the image will be loaded, e.g. ru-1. The address (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;

    • <keystone_token> — Keystone token that 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 do not know which format to specify, specify raw;

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

      If you download an archive with the container format .ovaWe recommend unpacking the archive before downloading to make the image work correctly.

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

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

  7. Get a reference to the image in the object store.

  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: <keystone_token>' \
      --data-raw '{"method":{"name":"web-download","uri":"<object_storage_url>"}}'

    Specify:

    • <pool> — pool into which the image will be loaded, e.g. ru-1. The address (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> — 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;
    • <keystone_token> — Keystone token that you copied in step 3;
    • <object_storage_url> — reference to an image in an object storage of the form https://<uuid>.selstorage.ru/container_name/object_namethat you got in step 7.

Download the vmdk from a file or from a link⁠

Check it out restrictions on the size of the downloaded image.

  1. Export the virtual machine from VMware in the format .ovf. Read more in the instructions Export an ovf Template VMware documentation.

    If the virtual disk type is MONOLITHIC_SPARSE or MONOLITHIC_FLATYou can skip this step, but we recommend that you export the VM in the following format .ovf.

  2. In control panel go to Cloud platform → Images.

  3. Click Create an image.

  4. Enter a name for the image.

  5. Select pool segment into 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 or URL as the image source.

  8. If you have selected a file, press Download.

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

  10. Select the format of the image:

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

  11. Select a container format:

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

  12. Optional: check the checkbox Specify minimum disk and memory capacity. Specify the minimum amount of RAM in MB and disk capacity in GB. When you create a cloud server from this image, the control panel or API will automatically check these limits.

  13. Click Create.

Create an image from a disk⁠

An image is a complete copy of a disk. An image can be created from any local or network cloud server disk. The disk can be either a boot disk or an optional disk. Check it out restrictions to the size of the disk from which you can create an image.

You can use the image:

  • to quickly configure identical cloud servers — server cloning. If the server has the operating system and software installed, 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.

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

  2. In control panel go to Cloud platform → Images.

  3. Click Create an image.

  4. Enter a name for the image.

  5. Select pool segment into 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 disk as the image source.

  8. Select the disk from which the image will be created. You can only create an image in the pool segment where the disk is located.

  9. Optional: check the checkbox Specify the minimum disk and memory capacity. Specify the minimum amount of RAM in MB and disk capacity in GB. When you create a cloud server from this image, the control panel or API will automatically check these limits.

  10. Click Create.