openstack-image
Manage Glance (OpenStack Image service) images
TLDR
List available images
Display image details
Create/upload an image
Delete image(s)
Save an image locally
SYNOPSIS
openstack image
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)