3.6. Managing images

3.6.1. vinfra service compute image create

Create a new compute image:

usage: vinfra service compute image create [--min-disk <size-gb>] [--min-ram <size-mb>]
                                           [--os-distro <os-distro>] [--protected]
                                           [--unprotected] [--public] [--public]
                                           [--disk-format <disk_format>]
                                           [--container-format <format>]
                                           [--tags <tags>] --file <file> <image-name>
--min-disk <size-gb>
Minimum disk size required to boot from image, in gigabytes
--min-ram <size-mb>
Minimum RAM size required to boot from image, in megabytes
--os-distro <os-distro>
OS distribution. To list available distributions, run vinfra service compute cluster show.
--protected
Protect image from deletion
--unprotected
Allow image to be deleted
--public
Make image accessible to all users
--private
Make image accessible only to the owners.
--disk-format <disk_format>
Disk format aki, ami, ari, detect, iso, ploop, qcow2, raw, vdi, vhd, vhdx, vmdk (default: detect)
--container-format <format>
Container format: aki, ami, ari, bare, docker, ovf, ova (default: bare)
--tags <tags>
A comma-separated list of tags
--file <file>
Create image from a local file
<image-name>
Image name

Example:

# vinfra service compute image create mycirrosimg \
--file /distr/cirros-0.4.0-x86_64-disk.img
Uploading image to server [elapsed time: 0:00:04]... |
+---------+--------------------------------------+
| Field   | Value                                |
+---------+--------------------------------------+
| task_id | 03874663-d03f-4891-a10b-64837e7faf43 |
+---------+--------------------------------------+

This command creates a task to create a Cirros image from the local file and upload it to Acronis Cyber Infrastructure.

Task outcome:

# vinfra task show 03874663-d03f-4891-a10b-64837e7faf43
+---------+------------------------------------------------------------------+
| Field   | Value                                                            |
+---------+------------------------------------------------------------------+
| details |                                                                  |
| name    | backend.presentation.compute.images.tasks.ImportComputeImageTask |
| result  | id: 179f45ef-c5d6-4270-b0c0-085b542544c5                         |
| state   | success                                                          |
| task_id | 03874663-d03f-4891-a10b-64837e7faf43                             |
+---------+------------------------------------------------------------------+

3.6.2. vinfra service compute image list

List compute images:

usage: vinfra service compute image list [--long] [--limit <num>]
                                         [--marker <image>] [--name <name>]
                                         [--id <id>] [--status <status>]
                                         [--placement <placement>]
                                         [--disk-format <disk-format>]
--long
Enable access and listing of all fields of objects.
--limit <num>
The maximum number of images to list. To list all images, set the option to -1.
--marker <image>
List images after the marker.
--name <name>
List images with the specified name or use a filter. Supported filter operator: contains. The filter format is <operator>:<value1>[,<value2>,...].
--id <id>
Show an image with the specified ID or list images using a filter. Supported filter operator: in. The filter format is <operator>:<value1>[,<value2>,...].
--status <status>
List images with the specified status or use a filter. Supported filter operator: in. The filter format is <operator>:<value1>[,<value2>,...].
--placement <placement>
List images added to a placement with the specified ID or use a filter. Supported filter operator: any. The filter format is <operator>:<value1>[,<value2>,...].
--disk-format <disk-format>
List images with the specified disk format.

Example:

# vinfra service compute image list
+--------------------------------------+-------------+----------+--------+-------------+
| id                                   | name        |     size | status | disk_format |
+--------------------------------------+-------------+----------+--------+-------------+
| 179f45ef-c5d6-4270-b0c0-085b542544c5 | mycirrosimg | 12716032 | active | qcow2       |
| 4741274f-5cca-4205-8f66-a2e89fb346cc | cirros      | 12716032 | active | qcow2       |
+--------------------------------------+-------------+----------+--------+-------------+

This command lists images available to the compute cluster.

3.6.3. vinfra service compute image show

Display compute image details:

usage: vinfra service compute image show <image>
<image>
Image ID or name

Example:

# vinfra service compute image show 4741274f-5cca-4205-8f66-a2e89fb346cc
+------------------+-------------------------------------------------------------------+
| Field            | Value                                                             |
+------------------+-------------------------------------------------------------------+
| checksum         | 443b7623e27ecf03dc9e01ee93f67afe                                  |
| container_format | bare                                                              |
| created_at       | 2018-09-11T13:29:10Z                                              |
| disk_format      | qcow2                                                             |
| file             | /api/v2/compute/images/4741274f-5cca-4205-8f66-a2e89fb346cc/file/ |
| id               | 4741274f-5cca-4205-8f66-a2e89fb346cc                              |
| min_disk         | 1                                                                 |
| min_ram          | 0                                                                 |
| name             | cirros                                                            |
| os_distro        | linux                                                             |
| os_type          | linux                                                             |
| placements       | []                                                                |
| project_id       | 72a5db3a033c403a86756021e601ef34                                  |
| protected        | False                                                             |
| public           | True                                                              |
| size             | 12716032                                                          |
| status           | active                                                            |
| tags             | []                                                                |
| updated_at       | 2018-09-11T13:29:13Z                                              |
| virtual_size     |                                                                   |
+------------------+-------------------------------------------------------------------+

This command shows the details of the default Cirros image.

3.6.4. vinfra service compute image set

Modify compute image parameters:

usage: vinfra service compute image set [--min-disk <size-gb>] [--min-ram <size-mb>]
                                        [--os-distro <os-distro>] [--protected]
                                        [--unprotected] [--public] [--private]
                                        [--name <name>] <image>
--min-disk <size-gb>
Minimum disk size required to boot from image, in gigabytes
--min-ram <size-mb>
Minimum RAM size required to boot from image, in megabytes
--os-distro <os-distro>
OS distribution. To list available distributions, run vinfra service compute cluster show.
--protected
Protect image from deletion
--unprotected
Allow image to be deleted
--public
Make image accessible to all users
--private
Make image accessible only to the owners.
--name <name>
Image name
<image>
Image ID or name

Example:

# vinfra service compute image set 4741274f-5cca-4205-8f66-a2e89fb346cc --protected --min-ram 1
+------------------+-------------------------------------------------------------------+
| Field            | Value                                                             |
+------------------+-------------------------------------------------------------------+
| checksum         | 443b7623e27ecf03dc9e01ee93f67afe                                  |
| container_format | bare                                                              |
| created_at       | 2018-09-11T13:29:10Z                                              |
| disk_format      | qcow2                                                             |
| file             | /api/v2/compute/images/4741274f-5cca-4205-8f66-a2e89fb346cc/file/ |
| id               | 4741274f-5cca-4205-8f66-a2e89fb346cc                              |
| min_disk         | 1                                                                 |
| min_ram          | 1                                                                 |
| name             | cirros                                                            |
| os_distro        | linux                                                             |
| os_type          | linux                                                             |
| project_id       | 72a5db3a033c403a86756021e601ef34                                  |
| protected        | True                                                              |
| size             | 12716032                                                          |
| status           | active                                                            |
| tags             | []                                                                |
| updated_at       | 2018-09-12T09:26:29Z                                              |
| virtual_size     |                                                                   |
| visibility       | public                                                            |
+------------------+-------------------------------------------------------------------+

This command protects the default Cirros image and sets the minimum RAM size for it to 1 GB.

3.6.5. vinfra service compute image save

Download a compute image:

usage: vinfra service compute image save [--file <filename>] <image>
--file <filename>
File to save the image to (default: stdout)
<image>
Image ID or name

Example:

# vinfra service compute image save 4741274f-5cca-4205-8f66-a2e89fb346cc --file cirros.qcow2
Operation successful

This command downloads the default Cirros image to the local disk as cirros.qcow2.

3.6.6. vinfra service compute image delete

Delete a compute image:

usage: vinfra service compute image delete <image>
<image>
Image ID or name

Example:

# vinfra service compute image delete 179f45ef-c5d6-4270-b0c0-085b542544c5
Operation successful

This command deletes the image with the ID 179f45ef-c5d6-4270-b0c0-085b542544c5.