# Verify operation

Verify operation of the Image service using CirrOS, a small Linux image that helps you test your OpenStack deployment.

For more information about how to download and build images, see OpenStack Virtual Machine Image Guide. For information about how to manage images, see the OpenStack End User Guide.

Note

Perform these commands on the controller node.

1. Source the `admin` credentials to gain access to admin-only CLI commands:

       $ . admin-openrc

2. Download the source image:

       $ wget http://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img

   Note

   Install `wget` if your distribution does not include it.

3. Upload the image to the Image service using the QCOW2 (QEMU Copy On Write 2) disk format, bare container format, and public visibility so all projects can access it:

       $ glance image-create --name "cirros" \
         --file cirros-0.4.0-x86_64-disk.img \
         --disk-format qcow2 --container-format bare \
         --visibility=public

       +------------------+------------------------------------------------------+
       | Field            | Value                                                |
       +------------------+------------------------------------------------------+
       | checksum         | 133eae9fb1c98f45894a4e60d8736619                     |
       | container_format | bare                                                 |
       | created_at       | 2015-03-26T16:52:10Z                                 |
       | disk_format      | qcow2                                                |
       | file             | /v2/images/cc5c6982-4910-471e-b864-1098015901b5/file |
       | id               | cc5c6982-4910-471e-b864-1098015901b5                 |
       | min_disk         | 0                                                    |
       | min_ram          | 0                                                    |
       | name             | cirros                                               |
       | owner            | ae7a98326b9c455588edd2656d723b9d                     |
       | protected        | False                                                |
       | schema           | /v2/schemas/image                                    |
       | size             | 13200896                                             |
       | status           | active                                               |
       | tags             |                                                      |
       | updated_at       | 2015-03-26T16:52:10Z                                 |
       | virtual_size     | None                                                 |
       | visibility       | public                                               |
       +------------------+------------------------------------------------------+

   For information about the glance parameters, see Image service (glance) command-line client in the `OpenStack User Guide`.

   For information about disk and container formats for images, see Disk and container formats for images in the `OpenStack Virtual Machine Image Guide`.

   Note

   OpenStack generates IDs dynamically, so you will see different values in the example command output.

4. Confirm upload of the image and validate attributes:

       $ glance image-list

       +--------------------------------------+--------+--------+
       | ID                                   | Name   | Status |
       +--------------------------------------+--------+--------+
       | 38047887-61a7-41ea-9b49-27987d5e8bb9 | cirros | active |
       +--------------------------------------+--------+--------+

this page last updated: 2026-03-18 20:42:57

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug