openstack-manuals/doc/user-guide/section_dashboard_manage_images.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>Create and manage images</title>
  <para>The cloud operator assigns roles to users. Roles determine
    who can upload and manage images. Operators might restrict the
    upload and management of images to cloud administrators or
    operators only.</para>
  <para>If you have admin privileges, you can use the dashboard to
    create and manage images in the <guilabel>admin</guilabel>
    project.</para>
  <note>
    <title>Manage images by using clients and APIs</title>
    <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>Create images</title>
    <para>For details about image creation, see the <link
        xlink:href="http://docs.openstack.org/image-guide/content/"
          ><citetitle>Virtual Machine Image
      Guide</citetitle></link>.</para>
    <procedure>
      <step>
        <para>Log in to the dashboard.</para>
        <para>Choose the <guilabel>admin</guilabel> project from the
            <guilabel>CURRENT PROJECT</guilabel> drop-down
          list.</para>
      </step>
      <step>
        <para>On the <guilabel>Project</guilabel> tab, click the
            <guilabel>Images &amp; Snapshots</guilabel>
          category.</para>
      </step>
      <step>
        <para>Click <guibutton>Create Image</guibutton>. The
            <guilabel>Create An Image</guilabel> window
          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>In the <guilabel>Create An Image</guilabel> window,
          enter or select 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>Enter a brief description about the
                  image.</para></td>
            </tr>
            <tr>
              <td><para><guilabel>Image
                Source</guilabel></para></td>
                <td>
                  <para>Choose the image source from the dropdown 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, there is an
                      <guilabel>Image File</guilabel> or <guilabel>Image Location</guilabel>
                      field. You can include the location URL or browse to the
                      image file on your file system and add it.</para>
                  </td>
            </tr>
            <tr>
              <td><para><guilabel>Format</guilabel></para></td>
              <td><para>Select the correct type from the drop-down menu
                (for example, QCOW2).</para>
              </td>
            </tr>
            <tr>
              <td><para><guilabel>Minimum Disk (GB)</guilabel> and
                    <guilabel>Minimum RAM (MB)</guilabel></para></td>
              <td><para>Leave these fields empty.</para>
              </td>
            </tr>
            <tr>
              <td><para><guilabel>Public</guilabel></para></td>
              <td><para>Select this option to make the image public to
                  all users.</para></td>
            </tr>
            <tr>
              <td><para><guilabel>Protected</guilabel></para></td>
              <td><para>Select this option to ensure that only users
                  with permissions can delete it.</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 images</title>
    <procedure>
      <step>
        <para>Log in to the dashboard.</para>
        <para>Choose the <guilabel>admin</guilabel> project from the
            <guilabel>CURRENT PROJECT</guilabel> drop-down
          list.</para>
      </step>
      <step>
        <para>On the <guilabel>Project</guilabel> tab, click the
            <guilabel>Images &amp; Snapshots</guilabel>
          category.</para>
      </step>
      <step>
        <para>Select the image that you want to edit. In the
            <guilabel>More</guilabel> drop-down list, click
            <guilabel>Edit</guilabel>.</para>
      </step>
      <step>
        <para>In the <guilabel>Update Image</guilabel> window, you can
          change the name for the image. Select the
            <guilabel>Public</guilabel> check box to make the image
          public. Clear this check box to make the image
          private.</para>
      </step>
      <step>
        <para>Click <guibutton>Update Image</guibutton>.</para>
      </step>
    </procedure>
  </section>
  <section xml:id="dashboard_delete_images">
    <title>Delete images</title>
    <procedure>
      <step>
        <para>Log in to the dashboard.</para>
        <para>Choose the <guilabel>admin</guilabel> project from the
            <guilabel>CURRENT PROJECT</guilabel> drop-down
          list.</para>
      </step>
      <step>
        <para>On the <guilabel>Project</guilabel> tab, click the
            <guilabel>Images &amp; Snapshots</guilabel>
          category.</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 <guilabel>Confirm Delete Image</guilabel> window,
          click <guibutton>Delete Images</guibutton> to confirm the
          deletion. You cannot undo this action.</para>
      </step>
    </procedure>
  </section>
</section>