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

Download and create an image

You can download images to the image repository:

You can create your own image from disk.

Download image from⁠

Images smaller than 100 GB can be downloaded from a file on your local computer.

  1. In Control Panel, go to Cloud Platform → Objects.

  2. Click Create Image.

  3. Enter a name for the image.

  4. Select the pool segment into which to load the image.

    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. More details about formats in the [Own Images] subsection(docs/cloud/servers/images/about-images.mdx#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 formats to specify, specify the image format as raw, the container format as bare.

  9. Optional: check the Specify minimum disk and memory size checkbox. 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 for these restrictions.

  10. Press Create.

Download large image⁠

Images larger than 100 GB can be downloaded via object storage.

  1. Upload image to object storage via segmented upload.

  2. Get Keystone token. Copy the value of x-subject-token.

  3. Open the CLI on the local computer.

  4. Create a request to create an image:

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

    Specify:

    • <pool> — pool into which to load the image, e.g. ru-1. The address (URL) varies by region and pool, can be viewed on the URL list;

    • <keystone_token> is the Keystone token that you copied in step 2;

    • <image_name> is the name of the image;

    • <image_format> is the format of the image. For more information about image formats, see Own Images. If you don't know which format to specify, specify raw;

    • <container_format> — container format. For more information about container 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 which format to specify, specify bare.

  5. In the query output, copy the value of id.

  6. Upload the image to the Selectel image store:

    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 to load the image, e.g. ru-1. The address (URL) varies by region and pool, can be viewed on the URL list;
    • <image_id> is the ID of the image you copied in step 5;
    • <pool_segment> — pool segment to which the image will be loaded, for example ru-1a;
    • <keystone_token> is the Keystone token that you copied in step 2;
    • <object_storage_url> — reference to the image in the object store of the form https://123456.selcdn.ru/bucket_name/object_name. Can be obtained using the Obtain link to object instruction.

You can download the image via a public link to the image file.

  1. In Control Panel, go to Cloud Platform → Objects.

  2. Click Create Image.

  3. Enter a name for the image.

  4. Select the pool segment into which to load the image.

    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 image source.

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

  8. Select an image format or container format. More details about formats in the [Own Images] subsection(docs/cloud/servers/images/about-images.mdx#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 formats to specify, specify the image format as raw, the container format as bare.

  9. Optional: check the Specify minimum disk and memory size checkbox. 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 for these restrictions.

  10. Press Create.

Download vmdk⁠

  1. Export the virtual machine from VMware in ovf format. See the Export an ovf Template instructions in the VMware documentation for details.

    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 Control Panel, go to Cloud Platform → Objects.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment into which to load the image.

    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, click Download.

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

  10. Select the format of the image:

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

  11. Select the container format:

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

  12. Optional: check the Specify minimum disk and memory size checkbox. 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 for these restrictions.

  13. Press Create.

Create an image from the disk⁠

The image can be created from any local or network disk of the cloud server, and the disk can be bootable or optional. An image is a complete copy of a disk.

You can use the image:

  • To quickly set up identical cloud servers — server cloning. If the operating system and software are installed on the 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.

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

  2. In Control Panel, go to Cloud Platform → Objects.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment into which to load the image.

    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 Specify minimum disk and memory size checkbox. 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 for these restrictions.

  10. Press Create.