[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

View File

@ -82,20 +82,21 @@ Then, during the boot process, you must:
* 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,
which contains the ``growpart`` tool for extending partitions.
* `cloud-initramfs-growroot <https://launchpad.net/cloud-initramfs-tools>`_
package for Ubuntu, Debian and Fedora, which supports resizing
root partition on the first boot.
* ``cloud-initramfs-growroot`` package for CentOS and RHEL.
* `cloud-init <https://launchpad.net/cloud-init>`__ package.
* the `cloud-init <https://launchpad.net/cloud-init>`__ package,
* the `cloud-utils <https://launchpad.net/cloud-utils>`_ package,
which, on Ubuntu and Debian, also contains the ``growpart`` tool for
extending partitions,
* if you use Fedora, CentOS 7, or RHEL 7, the ``cloud-utils-growpart``
package, which contains the ``growpart`` tool for extending partitions,
* 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
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
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
``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
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
from the metadata server and places the key in an account.
The account varies by distribution.
On Ubuntu-based virtual machines, the account is called ``ubuntu``.
On Fedora-based virtual machines, the account is called ``ec2-user``.
On Ubuntu-based virtual machines, the account is called ``ubuntu``,
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``
by editing the ``/etc/cloud/cloud.cfg`` file and adding a line
with a different user. For example, to configure ``cloud-init``
to put the key in an account named ``admin``, edit the
configuration file so it has the line:
to put the key in an account named ``admin``, use the following syntax
in the configuration file:
.. code-block:: yaml
user: admin
users:
- name: admin
(...)
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
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,
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
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
configuration. In general, you should not update the ``grub.cfg``
directly, since it is automatically generated.
If ``console=tty0 console=ttyS0,115200n8`` does not appear, you must
modify your grub configuration. In general, you should not update the
``grub.cfg`` directly, since it is automatically generated.
Instead, you should edit the ``/etc/default/grub`` file and modify the
value of the ``GRUB_CMDLINE_LINUX_DEFAULT`` variable:
.. 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
operating systems such as Ubuntu, run this command: