openstack-manuals/doc/install-guide-rst/source/glance-verify.rst

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. Create a temporary local directory:

   $ mkdir /tmp/images

4. Download the source image into it:

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

5. 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-0.3.4-x86_64" \
     --file /tmp/images/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-0.3.4-x86_64                  |
   | 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 <http://docs.openstack.org/cli-reference/content/ glanceclient_commands.html#glanceclient_subcommand_image-create>__ 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.

6. Confirm upload of the image and validate attributes:

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

7. Remove the temporary local directory and source image:

   $ rm -r /tmp/images