diskimage-builder/diskimage_builder/elements/ubuntu-minimal/README.rst
Michael Johnson e433aebf7d Add DIB_UBUNTU_KERNEL to ubuntu-minimal
This patch adds a new environment variable to the ubuntu-minimal
element called DIB_UBUNTU_KERNEL that allows you to specify the kernel
meta package that will be using to install the kernel inside the image.
It supports "linux-image-generic" (The default), "linux-image-kvm", and
"linux-image-virtual".
This allows building images that are smaller in size (~200MB smaller
qcow2) that have only the kernel modules necessary for virtual
machines.

Change-Id: I8ce65e1d357d15e8ed8995ad1dcaea02bbd1986f
2019-06-20 10:18:23 -07:00

31 lines
1013 B
ReStructuredText

==============
ubuntu-minimal
==============
The ``ubuntu-minimal`` element uses debootstrap for generating a
minimal image. In contrast the ``ubuntu`` element uses the cloud-image
as the initial base.
By default this element creates the latest LTS release. The exact
setting can be found in the element's ``environment.d`` directory in
the variable ``DIB_RELEASE``. If a different release of Ubuntu should
be created, the variable ``DIB_RELEASE`` can be set appropriately.
Note that this element installs ``systemd-sysv`` as the init system for
18.04+.
Environment Variables
---------------------
DIB_UBUNTU_KERNEL:
:Required: No
:Default: ``linux-image-generic``
:Description: Specifies the kernel meta package to install in the image.
:Example: ``DIB_UBUNTU_KERNEL=linux-image-kvm``
:Options: ``linux-image-generic``, ``linux-image-kvm``,
``linux-image-virtual``
:Notes: The element must know about the package, otherwise it will select
the default.
.. element_deps::