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 User Guide.

1. In each client environment script, configure the Image service client to use API version 2.0:

   $ echo "export OS_IMAGE_API_VERSION=2" \
     | tee -a admin-openrc.sh demo-openrc.sh
   

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

   $ source admin-openrc.sh
   

3. Download the source image:

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

   Note

   Install wget if your distribution does not include it.

4. Upload the image to the Image service using the QCOW2 disk format, bare container format, and public visibility so all projects can access it:

   $ glance image-create --name "cirros" \
     --file cirros-0.3.4-x86_64-disk.img \
     --disk-format qcow2 --container-format bare \
     --visibility public --progress
   [=============================>] 100%
   +------------------+--------------------------------------+
   | Property         | Value                                |
   +------------------+--------------------------------------+
   | checksum         | 133eae9fb1c98f45894a4e60d8736619     |
   | container_format | bare                                 |
   | created_at       | 2015-03-26T16:52:10Z                 |
   | disk_format      | qcow2                                |
   | id               | 38047887-61a7-41ea-9b49-27987d5e8bb9 |
   | min_disk         | 0                                    |
   | min_ram          | 0                                    |
   | name             | cirros                               |
   | owner            | ae7a98326b9c455588edd2656d723b9d     |
   | protected        | False                                |
   | size             | 13200896                             |
   | status           | active                               |
   | tags             | []                                   |
   | updated_at       | 2015-03-26T16:52:10Z                 |
   | virtual_size     | None                                 |
   | visibility       | public                               |
   +------------------+--------------------------------------+
   

   For information about the glance image-create parameters, see Image service command-line client in the OpenStack Command-Line Interface Reference.

   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.

5. Confirm upload of the image and validate attributes:

   $ glance image-list
   +--------------------------------------+--------+
   | ID                                   | Name   |
   +--------------------------------------+--------+
   | 38047887-61a7-41ea-9b49-27987d5e8bb9 | cirros |
   +--------------------------------------+--------+