4371ddd3f9
Give a specific directory so that it's clear that this is not a subdirectory of the Image store (/var/lib/glance). Also, remove the created directory at the end to make it clear that this is a temporary download. Change-Id: If42e5e891e728e7fb87318e29d88ede1376294b2 Closes-Bug: #1271018
181 lines
11 KiB
XML
181 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xml:id="glance-verify" xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<title>Verify the Image Service installation</title>
|
|
<para>To test the Image Service installation, download at least
|
|
one virtual machine image that is known to work with
|
|
OpenStack. For example, CirrOS is a small test image that is
|
|
often used for testing OpenStack deployments (<link
|
|
xlink:href="http://download.cirros-cloud.net/">CirrOS
|
|
downloads</link>). This walk through uses the 64-bit
|
|
CirrOS QCOW2 image.</para>
|
|
<para>For more information about how to download and build images,
|
|
see <link
|
|
xlink:href="http://docs.openstack.org/image-guide/content/index.html"
|
|
><citetitle>OpenStack Virtual Machine Image
|
|
Guide</citetitle></link>. For information about how to
|
|
manage images, see the <link
|
|
xlink:href="http://docs.openstack.org/user-guide/content/index.html"
|
|
><citetitle>OpenStack User
|
|
Guide</citetitle></link>.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Download the image into a dedicated directory using
|
|
<command>wget</command> or
|
|
<command>curl</command>:</para>
|
|
<screen><prompt>$</prompt> <userinput>mkdir /tmp/images</userinput>
|
|
<prompt>$</prompt> <userinput>cd /tmp/images/</userinput>
|
|
<prompt>$</prompt> <userinput>wget http://cdn.download.cirros-cloud.net/0.3.2/cirros-0.3.2-x86_64-disk.img</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Upload the image to the Image Service:</para>
|
|
<para><screen><prompt>$</prompt> <userinput>glance image-create --name=<replaceable>IMAGELABEL</replaceable> --disk-format=<replaceable>FILEFORMAT</replaceable> \
|
|
--container-format=<replaceable>CONTAINERFORMAT</replaceable> --is-public=<replaceable>ACCESSVALUE</replaceable> < <replaceable>IMAGEFILE</replaceable></userinput></screen></para>
|
|
<para>Where:</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><literal><replaceable>IMAGELABEL</replaceable></literal></term>
|
|
<listitem>
|
|
<para>Arbitrary label. The name by which users
|
|
refer to the image.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><literal><replaceable>FILEFORMAT</replaceable></literal></term>
|
|
<listitem>
|
|
<para>Specifies the format of the image file.
|
|
Valid formats include
|
|
<literal>qcow2</literal>,
|
|
<literal>raw</literal>,
|
|
<literal>vhd</literal>,
|
|
<literal>vmdk</literal>,
|
|
<literal>vdi</literal>,
|
|
<literal>iso</literal>,
|
|
<literal>aki</literal>,
|
|
<literal>ari</literal>, and
|
|
<literal>ami</literal>.</para>
|
|
<para>You can verify the format using the
|
|
<command>file</command> command:
|
|
<screen><prompt>$</prompt> <userinput>file cirros-0.3.2-x86_64-disk.img</userinput>
|
|
<computeroutput>cirros-0.3.2-x86_64-disk.img: QEMU QCOW Image (v2), 41126400 bytes</computeroutput></screen></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><literal><replaceable>CONTAINERFORMAT</replaceable></literal></term>
|
|
<listitem>
|
|
<para>Specifies the container format. Valid
|
|
formats include: <literal>bare</literal>,
|
|
<literal>ovf</literal>,
|
|
<literal>aki</literal>,
|
|
<literal>ari</literal> and
|
|
<literal>ami</literal>.</para>
|
|
<para>Specify <literal>bare</literal> to
|
|
indicate that the image file is not in a
|
|
file format that contains metadata about
|
|
the virtual machine. Although this field
|
|
is currently required, it is not actually
|
|
used by any of the OpenStack services and
|
|
has no effect on system behavior. Because
|
|
the value is not used anywhere, it is safe
|
|
to always specify <literal>bare</literal>
|
|
as the container format.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><literal><replaceable>ACCESSVALUE</replaceable></literal></term>
|
|
<listitem>
|
|
<para>Specifies image access: <itemizedlist>
|
|
<listitem>
|
|
<para>true - All users can view and
|
|
use the image.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>false - Only administrators
|
|
can view and use the image.</para>
|
|
</listitem>
|
|
</itemizedlist></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><literal><replaceable>IMAGEFILE</replaceable></literal></term>
|
|
<listitem>
|
|
<para>Specifies the name of your downloaded
|
|
image file.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para>For example:</para>
|
|
<screen><prompt>$</prompt> <userinput>source admin-openrc.sh</userinput>
|
|
<prompt>$</prompt> <userinput>glance image-create --name "cirros-0.3.2-x86_64" --disk-format qcow2 \
|
|
--container-format bare --is-public True --progress < cirros-0.3.2-x86_64-disk.img</userinput>
|
|
<computeroutput>+------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+------------------+--------------------------------------+
|
|
| checksum | 64d7c1cd2b6f60c92c14662941cb7913 |
|
|
| container_format | bare |
|
|
| created_at | 2014-04-08T18:59:18 |
|
|
| deleted | False |
|
|
| deleted_at | None |
|
|
| disk_format | qcow2 |
|
|
| id | acafc7c0-40aa-4026-9673-b879898e1fc2 |
|
|
| is_public | True |
|
|
| min_disk | 0 |
|
|
| min_ram | 0 |
|
|
| name | cirros-0.3.2-x86_64 |
|
|
| owner | efa984b0a914450e9a47788ad330699d |
|
|
| protected | False |
|
|
| size | 13167616 |
|
|
| status | active |
|
|
| updated_at | 2014-01-08T18:59:18 |
|
|
+------------------+--------------------------------------+</computeroutput></screen>
|
|
<note>
|
|
<para>Because the returned image ID is generated
|
|
dynamically, your deployment generates a different
|
|
ID than the one shown in this example.</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>Confirm that the image was uploaded and display its
|
|
attributes:</para>
|
|
<screen><prompt>$</prompt> <userinput>glance image-list</userinput></screen>
|
|
<screen><computeroutput>+--------------------------------------+---------------------+-------------+------------------+----------+--------+
|
|
| ID | Name | Disk Format | Container Format | Size | Status |
|
|
+--------------------------------------+---------------------+-------------+------------------+----------+--------+
|
|
| acafc7c0-40aa-4026-9673-b879898e1fc2 | cirros-0.3.2-x86_64 | qcow2 | bare | 13167616 | active |
|
|
+--------------------------------------+---------------------+-------------+------------------+----------+--------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
You can now remove the locally downloaded image, since it
|
|
is stored and available through the Image Service.
|
|
</para>
|
|
<screen><prompt>$</prompt> <userinput>rm -r /tmp/images</userinput></screen>
|
|
</step>
|
|
</procedure>
|
|
<para>Alternatively, the upload to the Image Service can be done without having to use local disk space to store the file, by use of the <parameter>--copy-from</parameter> parameter.</para>
|
|
<para>For example:</para>
|
|
<screen><prompt>$</prompt> <userinput>glance image-create --name="cirros-0.3.2-x86_64" --disk-format=qcow2 \
|
|
--container-format=bare --is-public=true \
|
|
--copy-from http://cdn.download.cirros-cloud.net/0.3.2/cirros-0.3.2-x86_64-disk.img</userinput>
|
|
<computeroutput>+------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+------------------+--------------------------------------+
|
|
| checksum | 64d7c1cd2b6f60c92c14662941cb7913 |
|
|
| container_format | bare |
|
|
| created_at | 2014-04-08T06:13:18 |
|
|
| deleted | False |
|
|
| disk_format | qcow2 |
|
|
| id | 3cce1e32-0971-4958-9719-1f92064d4f54 |
|
|
| is_public | True |
|
|
| min_disk | 0 |
|
|
| min_ram | 0 |
|
|
| name | cirros-0.3.2-x86_64 |
|
|
| owner | efa984b0a914450e9a47788ad330699d |
|
|
| protected | False |
|
|
| size | 13167616 |
|
|
| status | active |
|
|
| updated_at | 2014-04-08T06:13:20 |
|
|
+------------------+--------------------------------------+</computeroutput></screen>
|
|
</section>
|