openstack-manuals/doc/image-guide/source/create-images-manually.rst
Francesco Di Nucci 78179a67bf docs: review manual image creation
* Add TOCs
* Divide Examples and Tools (make it easier to add others such as VBox,
	VMware etc.)
* Merge all libvirt related content as a tool
* Modify headers as per Contributor Guide [1]
* Move pages to clarify hierarchy
Note: further work will be needed to update examples

[1] https://docs.openstack.org/doc-contrib-guide/rst-conv/titles.html

Change-Id: I78970ef578020c7df7e35ca59a1c7b8aed19bb6f
2024-07-11 13:25:37 +02:00

50 lines
1.7 KiB
ReStructuredText

======================
Create images manually
======================
Creating a new image is a step done outside of your
OpenStack installation. You create the new image manually on
your own system and then upload the image to your cloud.
To create a new image, you will need the installation CD or
DVD ISO file for the guest operating system. You will also need
access to a virtualization tool. You can use KVM for this. Or,
if you have a GUI desktop virtualization tool (such as, VMware
Fusion or VirtualBox), you can use that instead.
Convert the file to raw once you are done.
When you create a new virtual machine image, you will need
to connect to the graphical console of the hypervisor, which
acts as the virtual machine's display and allows you to interact
with the guest operating system's installer using your keyboard
and mouse. KVM can expose the graphical console using the
`VNC <https://en.wikipedia.org/wiki/Virtual_Network_Computing>`_
(Virtual Network Computing) protocol or the newer
`SPICE <http://spice-space.org>`_ protocol.
We will use the VNC protocol here, since you are more likely
to find a VNC client that works on your local desktop.
To create an image for the Database service,
see `Building Guest Images for OpenStack Trove
<https://docs.openstack.org/trove/latest/admin/building_guest_images.html>`_.
Tools
-----
.. toctree::
:maxdepth: 1
create-images-manually-tools-libvirt.rst
Examples
--------
.. toctree::
:maxdepth: 1
create-images-manually-example-centos-image.rst
create-images-manually-example-fedora-image.rst
create-images-manually-example-freebsd-image.rst
create-images-manually-example-windows-image.rst
create-images-manually-example-ubuntu-image.rst