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, which determines
    who can upload and manage images. Image upload and management
    might be restricted to only cloud administrators or cloud
    operators. If you have admin privileges, you can create and manage
    images in the admin project. You can also use the glance and nova
    clients or the Image Service and Compute APIs to manage images.
    See <xref linkend="cli_manage_images"/>.</para>
  <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 OpenStack 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
                Location</guilabel></para></td>
              <td><para>Include the URL of the image.</para></td>
            </tr>
            <tr>
              <td><para><guilabel>Image File</guilabel></para></td>
              <td><para>Alternatively, browse to find the file on your
                  machine.</para></td>
            </tr>
            <tr>
              <td><para><guilabel>Format</guilabel></para></td>
              <td><para>Select the image format.</para></td>
            </tr>
            <tr>
              <td><para><guilabel>Minimum Disk (GB)</guilabel> and
                    <guilabel>Maximum Disk (GB)</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 OpenStack 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 OpenStack 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>