228 lines
8.1 KiB
XML
228 lines
8.1 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="dashboard_manage_images">
|
|
<title>Upload and manage images</title>
|
|
<para>A virtual machine image, referred to in this document simply
|
|
as an image, is a single file that contains a virtual disk that
|
|
has a bootable operating system installed on it. Images are used
|
|
to create virtual machine instances within the cloud. For
|
|
information about creating image files, see the <link
|
|
xlink:href="http://docs.openstack.org/image-guide/content/"
|
|
><citetitle>OpenStack Virtual Machine Image
|
|
Guide</citetitle></link>.</para>
|
|
<para>Depending on your role, you may have permission to upload and
|
|
manage virtual machine images. Operators might restrict the upload
|
|
and management of images to cloud administrators or operators
|
|
only. If you have the appropriate privileges, you can use the
|
|
dashboard to upload and manage images in the
|
|
<guilabel>admin</guilabel> project.</para>
|
|
<note>
|
|
<para>You can also use the <command>glance</command> and
|
|
<command>nova</command> command-line clients or the Image
|
|
Service and Compute APIs to manage images. See <xref
|
|
linkend="cli_manage_images"/>.</para>
|
|
</note>
|
|
<section xml:id="dashboard_create_images">
|
|
<title>Upload an image</title>
|
|
<para>Follow this procedure to upload an image to a
|
|
project.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate
|
|
project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images & Snapshots</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Create Image</guibutton>.</para>
|
|
<para>The Create An Image dialog box appears.</para>
|
|
<informalfigure>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata
|
|
fileref="../common/figures/user_image_create.png"
|
|
format="PNG" width="4in" contentwidth="4in"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
</informalfigure>
|
|
</step>
|
|
<step>
|
|
<para>Enter the following values:</para>
|
|
<informaltable rules="all" width="75%">
|
|
<col width="25%"/>
|
|
<col width="75%"/>
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Name</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Enter a name for the image.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Description</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Optionally, enter a brief description of the
|
|
image.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Image Source</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Choose the image source from the list. Your
|
|
choices are <guilabel>Image Location</guilabel> and
|
|
<guilabel>Image File</guilabel>.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Image File</guilabel> or <guilabel>Image
|
|
Location</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Based on your selection for <guilabel>Image
|
|
Source</guilabel>, you either enter the location
|
|
URL of the image in the <guilabel>Image
|
|
Location</guilabel> field. or browse to the image
|
|
file on your system and add it.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Format</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select the correct format (for example, QCOW2)
|
|
for the image.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Minimum Disk (GB)</guilabel> and
|
|
<guilabel>Minimum RAM (MB)</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Leave these optional fields empty.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Public</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select this check box to make the image public
|
|
to all users with access to the current
|
|
project.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Protected</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select this check box to ensure that only users
|
|
with permissions can delete the image.</para>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</informaltable>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Create Image</guibutton>.</para>
|
|
<para>The image is queued to be uploaded. It might take some
|
|
time before the status changes from Queued to Active.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="dashboard_update_images">
|
|
<title>Update an image</title>
|
|
<para>Follow this procedure to update an existing image.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate
|
|
project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images & Snapshots</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select the image that you want to edit.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the <guilabel>Actions</guilabel> column, click
|
|
<guilabel>More</guilabel> and then select
|
|
<guilabel>Edit</guilabel> from the list.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the Update Image dialog box, you can perform the
|
|
following actions: <itemizedlist>
|
|
<listitem>
|
|
<para>Change the name of the image.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Select the <guilabel>Public</guilabel> check box
|
|
to make the image public.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Clear the <guilabel>Public</guilabel> check box to
|
|
make the image private.</para>
|
|
</listitem>
|
|
</itemizedlist></para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Update Image</guibutton>.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="dashboard_delete_images">
|
|
<title>Delete an image</title>
|
|
<para>Deletion of images is permanent and <emphasis role="bold"
|
|
>cannot</emphasis> be reversed. Only users with the
|
|
appropriate permissions can delete images.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate
|
|
project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images & Snapshots</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select the images that you want to delete.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Delete Images</guibutton>.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the Confirm Delete Image dialog box, click
|
|
<guibutton>Delete Images</guibutton> to confirm the
|
|
deletion.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|