f73c08af9a
In the subsection "Create an image (nova)", there is a sentence said "You cannot create a snapshot from an instance that has an attached volume", which must be wrong. Currently, nova supports creating image from an instance with attached volumes. Change-Id: I811a845b8ee028ab83a12af03364930a0394e18d Closes-Bug: #1341348
126 lines
8.6 KiB
XML
126 lines
8.6 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section 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" xml:id="nova_manage_images">
|
|
<title>Create an image (nova)</title>
|
|
<para>You can use the <command>nova</command> client to take a snapshot of a running instance to
|
|
create an image.</para>
|
|
<para>To minimize the potential for data loss and ensure that you create an accurate image, you
|
|
should shut down the instance before you take a snapshot.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Write any buffered data to disk.</para>
|
|
<para>For more information, see <link
|
|
xlink:href="http://docs.openstack.org/openstack-ops/content/snapshots.html"
|
|
>Taking Snapshots</link> in the <citetitle>OpenStack Operations
|
|
Guide</citetitle>.</para>
|
|
</step>
|
|
<step>
|
|
<para>List instances to get the server name:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova list</userinput>
|
|
<?db-font-size 50%?><computeroutput>+--------------------------------------+----------------------+--------+------------+-------------+------------------+
|
|
| ID | Name | Status | Task State | Power State | Networks |
|
|
+--------------------------------------+----------------------+--------+------------+-------------+------------------+
|
|
| 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | ACTIVE | None | Running | private=10.0.0.3 |
|
|
+--------------------------------------+----------------------+--------+------------+-------------+------------------+</computeroutput></screen>
|
|
<para>In this example, the instance is named <literal>myCirrosServer</literal>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Use this instance to create a snapshot:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova image-create myCirrosServer myCirrosImage</userinput></screen>
|
|
<para>The command creates a snapshot and automatically uploads the image to your
|
|
repository.</para>
|
|
<note>
|
|
<para>For snapshots that you create from an instance that was booted from a
|
|
volume:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>The snapshot is based on the volume that is attached to the instance
|
|
through the Block Storage service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>No data is uploaded to the Image Service.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>You can find information about the snapshot in the properties of the
|
|
image.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>Get details for your image to check its status:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova image-show myCirrosImage</userinput>
|
|
<?db-font-size 50%?><computeroutput>+-------------------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-------------------------------------+--------------------------------------+
|
|
| metadata owner_id | 66265572db174a7aa66eba661f58eb9e |
|
|
| minDisk | 0 |
|
|
| metadata instance_type_name | m1.small |
|
|
| metadata instance_type_id | 5 |
|
|
| metadata instance_type_memory_mb | 2048 |
|
|
| id | 7e5142af-1253-4634-bcc6-89482c5f2e8a |
|
|
| metadata instance_type_root_gb | 20 |
|
|
| metadata instance_type_rxtx_factor | 1 |
|
|
| metadata ramdisk_id | 3cf852bd-2332-48f4-9ae4-7d926d50945e |
|
|
| metadata image_state | available |
|
|
| metadata image_location | snapshot |
|
|
| minRam | 0 |
|
|
| metadata instance_type_vcpus | 1 |
|
|
| status | ACTIVE |
|
|
| updated | 2013-07-22T19:46:42Z |
|
|
| metadata instance_type_swap | 0 |
|
|
| metadata instance_type_vcpu_weight | None |
|
|
| metadata base_image_ref | 397e713c-b95b-4186-ad46-6126863ea0a9 |
|
|
| progress | 100 |
|
|
| metadata instance_type_flavorid | 2 |
|
|
| OS-EXT-IMG-SIZE:size | 14221312 |
|
|
| metadata image_type | snapshot |
|
|
| metadata user_id | 376744b5910b4b4da7d8e6cb483b06a8 |
|
|
| name | myCirrosImage |
|
|
| created | 2013-07-22T19:45:58Z |
|
|
| metadata instance_uuid | 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 |
|
|
| server | 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 |
|
|
| metadata kernel_id | df430cc2-3406-4061-b635-a51c16e488ac |
|
|
| metadata instance_type_ephemeral_gb | 0 |
|
|
+-------------------------------------+--------------------------------------+</computeroutput></screen>
|
|
<para>The image status changes from <literal>SAVING</literal> to
|
|
<literal>ACTIVE</literal>. Only the tenant who creates the image has access to
|
|
it.</para>
|
|
</step>
|
|
</procedure>
|
|
<para>To launch an instance from your image, include the image ID and flavor ID, as in the
|
|
following example:</para>
|
|
<screen><prompt>$</prompt> <userinput>nova boot newServer --image 7e5142af-1253-4634-bcc6-89482c5f2e8a \
|
|
--flavor 3</userinput>
|
|
<?db-font-size 50%?><computeroutput>+-------------------------------------+--------------------------------------+
|
|
| Property | Value |
|
|
+-------------------------------------+--------------------------------------+
|
|
| OS-EXT-STS:task_state | scheduling |
|
|
| image | myCirrosImage |
|
|
| OS-EXT-STS:vm_state | building |
|
|
| OS-EXT-SRV-ATTR:instance_name | instance-00000007 |
|
|
| flavor | m1.medium |
|
|
| id | d7efd3e4-d375-46d1-9d57-372b6e4bdb7f |
|
|
| security_groups | [{u'name': u'default'}] |
|
|
| user_id | 376744b5910b4b4da7d8e6cb483b06a8 |
|
|
| OS-DCF:diskConfig | MANUAL |
|
|
| accessIPv4 | |
|
|
| accessIPv6 | |
|
|
| progress | 0 |
|
|
| OS-EXT-STS:power_state | 0 |
|
|
| OS-EXT-AZ:availability_zone | nova |
|
|
| config_drive | |
|
|
| status | BUILD |
|
|
| updated | 2013-07-22T19:58:33Z |
|
|
| hostId | |
|
|
| OS-EXT-SRV-ATTR:host | None |
|
|
| key_name | None |
|
|
| OS-EXT-SRV-ATTR:hypervisor_hostname | None |
|
|
| name | newServer |
|
|
| adminPass | jis88nN46RGP |
|
|
| tenant_id | 66265572db174a7aa66eba661f58eb9e |
|
|
| created | 2013-07-22T19:58:33Z |
|
|
| metadata | {} |
|
|
+-------------------------------------+--------------------------------------+</computeroutput></screen>
|
|
</section>
|