From f73c08af9ae7c771691cbb9fff4a9f538e84f7ad Mon Sep 17 00:00:00 2001 From: lingxiankong Date: Mon, 14 Jul 2014 04:54:19 +0800 Subject: [PATCH] Fix wrong description for nova image-create 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 --- doc/common/section_cli_nova_manage_images.xml | 71 +++++++++++-------- 1 file changed, 40 insertions(+), 31 deletions(-) diff --git a/doc/common/section_cli_nova_manage_images.xml b/doc/common/section_cli_nova_manage_images.xml index ac954ee06a..bd63114141 100644 --- a/doc/common/section_cli_nova_manage_images.xml +++ b/doc/common/section_cli_nova_manage_images.xml @@ -1,25 +1,18 @@ -
+
Create an image (nova) - You can use the nova client to take a snapshot of a - running instance to create an image. - 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. - You cannot create a snapshot from an instance that has an attached - volume. Detach the volume, create the image, and remount the - volume. + You can use the nova client to take a snapshot of a running instance to + create an image. + 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. Write any buffered data to disk. - For more information, see Taking Snapshots in the - OpenStack Operations - Guide. + For more information, see Taking Snapshots in the OpenStack Operations + Guide. List instances to get the server name: @@ -29,13 +22,30 @@ +--------------------------------------+----------------------+--------+------------+-------------+------------------+ | 84c6e57d-a6b1-44b6-81eb-fcb36afd31b5 | myCirrosServer | ACTIVE | None | Running | private=10.0.0.3 | +--------------------------------------+----------------------+--------+------------+-------------+------------------+ - In this example, the server is named - myCirrosServer. - Use this server to create a snapshot: - $ nova image-create myCirrosServer myCirrosImageThe - command creates a qemu snapshot and automatically uploads the - image to your repository. Only the tenant that creates the image - has access to it. + In this example, the instance is named myCirrosServer. + + + Use this instance to create a snapshot: + $ nova image-create myCirrosServer myCirrosImage + The command creates a snapshot and automatically uploads the image to your + repository. + + For snapshots that you create from an instance that was booted from a + volume: + + + The snapshot is based on the volume that is attached to the instance + through the Block Storage service. + + + No data is uploaded to the Image Service. + + + You can find information about the snapshot in the properties of the + image. + + + Get details for your image to check its status: @@ -73,15 +83,14 @@ | metadata kernel_id | df430cc2-3406-4061-b635-a51c16e488ac | | metadata instance_type_ephemeral_gb | 0 | +-------------------------------------+--------------------------------------+ - The image status changes from - SAVING to - ACTIVE. Only the tenant who - creates the image has access to it. + The image status changes from SAVING to + ACTIVE. Only the tenant who creates the image has access to + it. - To launch an instance from your image, include the image ID - and flavor ID, as in the following example: - $ nova boot newServer --image 7e5142af-1253-4634-bcc6-89482c5f2e8a \ + To launch an instance from your image, include the image ID and flavor ID, as in the + following example: + $ nova boot newServer --image 7e5142af-1253-4634-bcc6-89482c5f2e8a \ --flavor 3 +-------------------------------------+--------------------------------------+ | Property | Value |