b88dd6d17b
Change-Id: Icf6d35f6f9b7b5d96955d41f643ef17c9bf9eb35 Implements: blueprint image-guide-rst Depends-On: I694301758f7f85290d4c9f9b01fbd1924b02b476
141 lines
6.0 KiB
ReStructuredText
141 lines
6.0 KiB
ReStructuredText
========================
|
|
Upload and manage images
|
|
========================
|
|
|
|
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 `OpenStack Virtual Machine
|
|
Image Guide <http://docs.openstack.org/image-guide/>`_.
|
|
|
|
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 admin project.
|
|
|
|
.. note:: You can also use the :command:`glance` and :command:`nova`
|
|
command-line clients or the Image service and Compute APIs to
|
|
manage images.
|
|
|
|
Upload an image
|
|
~~~~~~~~~~~~~~~
|
|
|
|
Follow this procedure to upload an image to a project:
|
|
|
|
#. Log in to the dashboard.
|
|
|
|
#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the
|
|
appropriate project.
|
|
|
|
#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and
|
|
click :guilabel:`Images` category.
|
|
|
|
#. Click :guilabel:`Create Image`.
|
|
|
|
The :guilabel:`Create An Image` dialog box appears.
|
|
|
|
#. Enter the following values:
|
|
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Name` | Enter a name for the image. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Description` | Enter a brief description of |
|
|
| | the image. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Image Source` | Choose the image source from |
|
|
| | the dropdown list. Your choices |
|
|
| | are :guilabel:`Image Location` |
|
|
| | and :guilabel:`Image File`. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Image File` or | Based on your selection for |
|
|
| :guilabel:`Image Location` | :guilabel:`Image Source`, you |
|
|
| | either enter the location URL |
|
|
| | of the image in the |
|
|
| | :guilabel:`Image Location` |
|
|
| | field, or browse for the image |
|
|
| | file on your file system and |
|
|
| | add it. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Format` | Select the image format (for |
|
|
| | example, QCOW2) for the image. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Architecture` | Specify the architecture. For |
|
|
| | example, ``i386`` for a 32-bit |
|
|
| | architecture or ``x86_64`` for |
|
|
| | a 64-bit architecture. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Minimum Disk (GB)` | Leave these fields empty. |
|
|
| and | |
|
|
| :guilabel:`Minimum RAM (MB)` | |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Copy Data` | Specify this option to copy |
|
|
| | image data to the Image service.|
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Public` | Select this check box to make |
|
|
| | the image public to all users |
|
|
| | with access to the current |
|
|
| | project. |
|
|
+-------------------------------+---------------------------------+
|
|
| :guilabel:`Protected` | Select this check box to ensure |
|
|
| | that only users with |
|
|
| | permissions can delete the |
|
|
| | image. |
|
|
+-------------------------------+---------------------------------+
|
|
|
|
#. Click :guilabel:`Create Image`.
|
|
|
|
The image is queued to be uploaded. It might take some time before
|
|
the status changes from Queued to Active.
|
|
|
|
Update an image
|
|
~~~~~~~~~~~~~~~
|
|
|
|
Follow this procedure to update an existing image.
|
|
|
|
#. Log in to the dashboard.
|
|
|
|
#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the
|
|
appropriate project.
|
|
|
|
#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and
|
|
click :guilabel:`Images` category.
|
|
|
|
#. Select the image that you want to edit.
|
|
|
|
#. In the :guilabel:`Actions` column, click :guilabel:`More` and then
|
|
select :guilabel:`Edit Image` from the list.
|
|
|
|
#. In the :guilabel:`Update Image` dialog box, you can perform the
|
|
following actions:
|
|
|
|
- Change the name of the image.
|
|
|
|
- Select the :guilabel:`Public` check box to make the image public.
|
|
|
|
- Clear the :guilabel:`Public` check box to make the image private.
|
|
|
|
#. Click :guilabel:`Update Image`.
|
|
|
|
Delete an image
|
|
~~~~~~~~~~~~~~~
|
|
|
|
Deletion of images is permanent and **cannot** be reversed. Only users
|
|
with the appropriate permissions can delete images.
|
|
|
|
#. Log in to the dashboard.
|
|
|
|
#. From the CURRENT PROJECT on the :guilabel:`Project` tab, select the
|
|
appropriate project.
|
|
|
|
#. On the :guilabel:`Project` tab, open the :guilabel:`Compute` tab and
|
|
click :guilabel:`Images` category.
|
|
|
|
#. Select the images that you want to delete.
|
|
|
|
#. Click :guilabel:`Delete Images`.
|
|
|
|
#. In the :guilabel:`Confirm Delete Images` dialog box, click
|
|
:guilabel:`Delete Images` to confirm the deletion.
|