openstack
/
openstack-manuals
Code Issues Proposed changes

[image-guide] Sync openstack-images.rst with other pages 

Update per I9cfdf6b75bd3e47a354b3d4095209f7f3c0aaf48.

Change-Id: Ied7d1caafa1f87f9428c8ef17e460d772ae626d1
This commit is contained in:
Petr Kovar 2017-04-28 19:27:20 +02:00
parent 121b7a06f3
commit a68c14b2f9
1 changed files with 27 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
doc/image-guide/source/openstack-images.rst
View File

@ -82,20 +82,21 @@ Then, during the boot process, you must:
* Resize the root volume file system. * Resize the root volume file system.
The simplest way to support this is to install in your image the: Depending on your distribution, the simplest way to support this is to install
in your image:
* `cloud-utils <https://launchpad.net/cloud-utils>`_ package, * the `cloud-init <https://launchpad.net/cloud-init>`__ package,
which contains the ``growpart`` tool for extending partitions. * the `cloud-utils <https://launchpad.net/cloud-utils>`_ package,
* `cloud-initramfs-growroot <https://launchpad.net/cloud-initramfs-tools>`_ which, on Ubuntu and Debian, also contains the ``growpart`` tool for
package for Ubuntu, Debian and Fedora, which supports resizing extending partitions,
root partition on the first boot. * if you use Fedora, CentOS 7, or RHEL 7, the ``cloud-utils-growpart``
* ``cloud-initramfs-growroot`` package for CentOS and RHEL. package, which contains the ``growpart`` tool for extending partitions,
* `cloud-init <https://launchpad.net/cloud-init>`__ package. * if you use Ubuntu or Debian, the
`cloud-initramfs-growroot <https://launchpad.net/cloud-initramfs-tools>`_
package , which supports resizing root partition on the first boot.
With these packages installed, the image performs the root partition With these packages installed, the image performs the root partition
resize on boot. For example, in the ``/etc/rc.local`` file. resize on boot. For example, in the ``/etc/rc.local`` file.
These packages are in the Ubuntu and Debian package repository, as well as
the EPEL repository (for Fedora/RHEL/CentOS/Scientific Linux guests).
If you cannot install ``cloud-initramfs-tools``, Robert Plestenjak If you cannot install ``cloud-initramfs-tools``, Robert Plestenjak
has a GitHub project called `linux-rootfs-resize has a GitHub project called `linux-rootfs-resize
@ -103,7 +104,7 @@ has a GitHub project called `linux-rootfs-resize
that contains scripts that update a ramdisk by using that contains scripts that update a ramdisk by using
``growpart`` so that the image resizes properly on boot. ``growpart`` so that the image resizes properly on boot.
If you can install the cloud-utils and ``cloud-init`` packages, If you can install the ``cloud-init`` and ``cloud-utils`` packages,
we recommend that when you create your images, you create we recommend that when you create your images, you create
a single ext3 or ext4 partition (not managed by LVM). a single ext3 or ext4 partition (not managed by LVM).
@ -199,18 +200,21 @@ Use cloud-init to fetch the public key
The ``cloud-init`` package automatically fetches the public key The ``cloud-init`` package automatically fetches the public key
from the metadata server and places the key in an account. from the metadata server and places the key in an account.
The account varies by distribution. The account varies by distribution.
On Ubuntu-based virtual machines, the account is called ``ubuntu``. On Ubuntu-based virtual machines, the account is called ``ubuntu``,
On Fedora-based virtual machines, the account is called ``ec2-user``. on Fedora-based virtual machines, the account is called ``fedora``,
and on CentOS-based virtual machines, the account is called ``centos``.
You can change the name of the account used by ``cloud-init`` You can change the name of the account used by ``cloud-init``
by editing the ``/etc/cloud/cloud.cfg`` file and adding a line by editing the ``/etc/cloud/cloud.cfg`` file and adding a line
with a different user. For example, to configure ``cloud-init`` with a different user. For example, to configure ``cloud-init``
to put the key in an account named ``admin``, edit the to put the key in an account named ``admin``, use the following syntax
configuration file so it has the line: in the configuration file:
.. code-block:: yaml .. code-block:: yaml
user: admin users:
- name: admin
(...)
Write a custom script to fetch the public key Write a custom script to fetch the public key
--------------------------------------------- ---------------------------------------------
@ -301,7 +305,8 @@ Ensure image writes boot log to console
You must configure the image so that the kernel writes You must configure the image so that the kernel writes
the boot log to the ``ttyS0`` device. In particular, the the boot log to the ``ttyS0`` device. In particular, the
``console=ttyS0`` argument must be passed to the kernel on boot. ``console=tty0 console=ttyS0,115200n8`` arguments must be passed to
the kernel on boot.
If your image uses ``grub2`` as the boot loader, If your image uses ``grub2`` as the boot loader,
there should be a line in the grub configuration file. there should be a line in the grub configuration file.
@ -309,17 +314,17 @@ For example, ``/boot/grub/grub.cfg``, which looks something like this:
.. code-block:: console .. code-block:: console
linux /boot/vmlinuz-3.2.0-49-virtual root=UUID=6d2231e4-0975-4f35-a94f-56738c1a8150 ro console=ttyS0 linux /boot/vmlinuz-3.2.0-49-virtual root=UUID=6d2231e4-0975-4f35-a94f-56738c1a8150 ro console=tty0 console=ttyS0,115200n8
If ``console=ttyS0`` does not appear, you must modify your grub If ``console=tty0 console=ttyS0,115200n8`` does not appear, you must
configuration. In general, you should not update the ``grub.cfg`` modify your grub configuration. In general, you should not update the
directly, since it is automatically generated. ``grub.cfg`` directly, since it is automatically generated.
Instead, you should edit the ``/etc/default/grub`` file and modify the Instead, you should edit the ``/etc/default/grub`` file and modify the
value of the ``GRUB_CMDLINE_LINUX_DEFAULT`` variable: value of the ``GRUB_CMDLINE_LINUX_DEFAULT`` variable:
.. code-block:: bash .. code-block:: bash
GRUB_CMDLINE_LINUX_DEFAULT="console=ttyS0" GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200n8"
Next, update the grub configuration. On Debian-based Next, update the grub configuration. On Debian-based
operating systems such as Ubuntu, run this command: operating systems such as Ubuntu, run this command: