openstack-manuals/doc/image-guide/ch_obtaining_images.xml
Thomas Goirand 373b47a5e2 Tell about official Debian OpenStack images
Since a few days, Debian now produces official OpenStack images
using the shell script I wrote and packaged. This patch tells
the world about it.

Change-Id: I5b15329e2f3a7f6f3ce7b8d44e14cfed459c5519
2015-01-29 15:56:05 +01:00

146 lines
8.1 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<chapter 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="ch_obtaining_images">
<title>Get images</title>
<?dbhtml stop-chunking?>
<para>The simplest way to obtain a virtual machine image that works with OpenStack is to
download one that someone else has already created.</para>
<section xml:id="cirros-images">
<title>CirrOS (test) images</title>
<para>CirrOS is a minimal Linux distribution that was designed for use as a test image on
clouds such as OpenStack Compute. You can download a CirrOS image in various formats
from the <link xlink:href="https://download.cirros-cloud.net">CirrOS
download page</link>.</para>
<para>If your deployment uses QEMU or KVM, we recommend using the images in qcow2
format. The most recent 64-bit qcow2 image as of this writing is <link
xlink:href="http://download.cirros-cloud.net/0.3.3/cirros-0.3.3-x86_64-disk.img"
>cirros-0.3.3-x86_64-disk.img</link>
<note>
<para>In a CirrOS image, the login account is <literal>cirros</literal>. The
password is <literal>cubswin:)</literal></para>
</note></para>
</section>
<section xml:id="ubuntu-images">
<title>Official Ubuntu images</title>
<para>Canonical maintains an <link xlink:href="http://cloud-images.ubuntu.com/">official
set of Ubuntu-based images</link>.</para>
<para>Images are arranged by Ubuntu release, and by image release date, with "current" being
the most recent. For example, the page that contains the most recently built image for
Ubuntu 14.04 "Trusty Tahr" is <link
xlink:href="http://cloud-images.ubuntu.com/trusty/current/"
>http://cloud-images.ubuntu.com/trusty/current/</link>. Scroll to the bottom of the
page for links to images that can be downloaded directly.</para>
<para>If your deployment uses QEMU or KVM, we recommend using the images in qcow2
format. The most recent version of the 64-bit QCOW2 image for Ubuntu 14.04 is <link
xlink:href="http://uec-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img"
>trusty-server-cloudimg-amd64-disk1.img</link>.<note>
<para>In an Ubuntu cloud image, the login account is
<literal>ubuntu</literal>.</para>
</note></para>
</section>
<section xml:id="redhat-images">
<title>Official Red Hat Enterprise Linux images</title>
<para>
Red Hat maintains official Red Hat Enterprise Linux cloud
images. A valid Red Hat Enterprise Linux subscription is required
to download these images:
</para>
<itemizedlist>
<listitem>
<para>
<link xlink:href="https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.0/x86_64/product-downloads"
>Red Hat Enterprise Linux 7 KVM Guest Image</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="https://rhn.redhat.com/rhn/software/channel/downloads/Download.do?cid=16952"
>Red Hat Enterprise Linux 6 KVM Guest Image</link>
</para>
</listitem>
</itemizedlist>
<note>
<para>
In a RHEL image, the login account is <literal>cloud-user</literal>.
</para>
</note>
</section>
<section xml:id="fedora-images">
<title>Official Fedora images</title>
<para>The Fedora project maintains a list of official cloud images at
<link xlink:href="https://getfedora.org/en/cloud/download/" />. The images
include the <systemitem class="process">cloud-init</systemitem>
utility to support key and user data injection. The default user
name is <systemitem class="username">fedora</systemitem>.
<note>
<para>In a Fedora image, the login account is <literal>fedora</literal>.</para>
</note></para>
</section>
<section xml:id="suse-sles-images">
<title>Official openSUSE and SLES images</title>
<para>SUSE does not provide openSUSE or SUSE Linux Enterprise
Server (SLES) images for direct download. Instead, they
provide a web-based tool called <link
xlink:href="http://susestudio.com">SUSE Studio</link>
that you can use to build openSUSE and SLES images.</para>
</section>
<section xml:id="debian-images">
<title>Official Debian images</title>
<para>Since January 2015,
<link xlink:href="http://cdimage.debian.org/cdimage/openstack/">Debian
provides images for direct download</link>. They are now made at the
same time as the CD and DVD images of Debian. However, until Debian 8.0
(aka Jessie) is out, these images are the weekly built images of the
testing distribution.</para>
<para>If you wish to build your own images of Debian 7.0 (aka Wheezy, the
current stable release of Debian), you can use the package which is
used to build the official Debian images. It is named
<package>openstack-debian-images</package>, and it
provides a simple script for building them. This package is available
in Debian Unstable, Debian Jessie, and through the wheezy-backports
repositories. To produce a Wheezy image, simply run:
<screen><prompt>#</prompt> <userinput>build-openstack-debian-image -r wheezy</userinput></screen></para>
<para>If building the image for Wheezy, packages like
<package>cloud-init</package>, <package>cloud-utils</package> or
<package>cloud-initramfs-growroot</package> will be pulled from
wheezy-backports. Also, the current version of
<package>bootlogd</package> in Wheezy doesn't support logging to
multiple consoles, which is needed so that both the OpenStack
Dashboard console and the <command>nova console-log</command>
console works. However, a <link
xlink:href="http://archive.gplhost.com/debian/pool/juno-backports/main/s/sysvinit/bootlogd_2.88dsf-41+deb7u2_amd64.deb">
fixed version is available from the non-official GPLHost
repository</link>. To install it on top of the image, it is possible
to use the <option>--hook-script</option> option of the
<command>build-openstack-debian-image</command> script, with this
kind of script as parameter:
<programlisting language="bash">#!/bin/sh
cp bootlogd_2.88dsf-41+deb7u2_amd64.deb ${BODI_CHROOT_PATH}
chroot ${BODI_CHROOT_PATH} dpkg -i bootlogd_2.88dsf-41+deb7u2_amd64.deb
rm ${BODI_CHROOT_PATH}/bootlogd_2.88dsf-41+deb7u2_amd64.deb</programlisting></para>
</section>
<section xml:id="other-distros">
<title>Official images from other Linux distributions</title>
<para>As of this writing, we are not aware of other distributions that provide images for download.</para>
</section>
<section xml:id="rcb-images">
<title>Rackspace Cloud Builders (multiple distros)
images</title>
<para>Rackspace Cloud Builders maintains a list of pre-built images from various
distributions (Red Hat, CentOS, Fedora, Ubuntu). Links to these images can be found at
<link xlink:href="https://github.com/rackerjoe/oz-image-build"
>rackerjoe/oz-image-build on GitHub</link>.</para>
</section>
<section xml:id="windows-images">
<title>Microsoft Windows images</title>
<para>Cloudbase Solutions hosts an <link xlink:href="http://www.cloudbase.it/ws2012r2/"
>OpenStack Windows Server 2012 Standard Evaluation image</link> that runs on
Hyper-V, KVM, and XenServer/XCP.</para>
</section>
</chapter>