LinuxCommandLibrary

openstack-image

Manage Glance (OpenStack Image service) images

TLDR

List available images

$ openstack image list [--private|--shared|--all]
copy

Display image details
$ openstack image show --human-readable [image_id]
copy

Create/upload an image
$ openstack image create --file [path/to/file] [--private|--shared|--all] [image_name]
copy

Delete image(s)
$ openstack image delete [image_id1 image_id2 ...]
copy

Save an image locally
$ openstack image save --file [filename] [image_id]
copy

SYNOPSIS

openstack image [options]

PARAMETERS

create
    Create a new image.

delete
    Delete an image.

list
    List available images.

set
    Update an existing image.

show
    Display details of an image.

--public
    Make the image publicly accessible.

--private
    Make the image privately accessible.

--file
    Path to the image file to upload.

--disk-format
    Specify the disk format (e.g., qcow2, vmdk).

--container-format
    Specify the container format (e.g., bare, ova).

--tag
    Add a tag to the image. Can be specified multiple times.

--property
    Set a custom image property. Can be specified multiple times.

DESCRIPTION

The `openstack image` command provides a command-line interface for managing images within an OpenStack environment. This command allows users to perform various actions related to images, such as creating, listing, showing details, updating, deleting, and importing images. It interacts with the OpenStack Glance service, which is responsible for storing and managing virtual machine images. Users can specify image properties like name, disk format, container format, visibility, and tags. Furthermore, it supports filtering and sorting image lists, enabling efficient image management. This command is a crucial tool for managing virtual machine images in OpenStack clouds.

Authentication to the OpenStack cloud is typically required before using this command. This can be done using environment variables or by passing authentication parameters directly to the command. Proper configuration is essential for the command to connect to the OpenStack services correctly.

CAVEATS

Requires OpenStack CLI to be properly configured and authenticated to an OpenStack environment.

IMAGE METADATA

Images can have associated metadata that describes their contents and purpose. This metadata can be used to filter and manage images effectively. Properties such as operating system, version, and applications installed can be stored as metadata.

IMAGE FORMATS

OpenStack Glance supports various image formats, including qcow2, vmdk, iso, and raw. Choosing the right image format is important for performance and compatibility with different hypervisors.

HISTORY

The `openstack image` command has evolved with the OpenStack project. Originally part of the separate `glance` command-line client, it was integrated into the unified `openstack` client to provide a more consistent user experience across OpenStack services. Its development has mirrored the evolution of Glance, adding support for new image formats, metadata, and storage backends.

SEE ALSO

openstack server(1), openstack flavor(1), glance(1)

Copied to clipboard