sig_cloud/diskimage-builder
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
diskimage-builder/diskimage_builder/elements/ubuntu-minimal/README.rst

48 lines
1.7 KiB
ReStructuredText
Raw Permalink Normal View History

Create docs site containing element READMEs We currently do not have the ability to create a docs site which outlines all the elements. Change-Id: I77ccf61e0c4b1509b3e7ce9b8f15ea5ccfd50d9b
2015-02-07 10:30:02 +00:00
==============
ubuntu-minimal
==============
Flagging ubuntu-minimal as untested Change-Id: I5f4973b9b81d97552d02ab3e64314bce827542f4
2015-03-13 04:22:12 +00:00
Unify and fix doc of several Debian and Ubuntu elements This patch removes three nearly-copies of debootstrap documentation and fixes some documentation aspects. Change-Id: Ief7794f5c1abad73788c063af6c862472cd34744 Signed-off-by: Andreas Florath <andreas@florath.net>
2017-01-17 19:59:16 +00:00
The ``ubuntu-minimal`` element uses debootstrap for generating a
minimal image. In contrast the ``ubuntu`` element uses the cloud-image
as the initial base.
General improvements to the ubuntu-minimal docs This change: - adds a note regarding an error when building focal ubuntu-minimal images on operating systems with older versions of debootstrap - adds a reference to where the DIB_RELEASE variable definition can be found Closes-Bug: #1941831 Change-Id: Ibc1e04dba0562c4f4909a8cb8af041d9b8ac45c4
2021-08-27 05:22:08 +00:00
.. note::
You will need to install a working debootstrap for diskimage-builder. The
version you install may not support all Debian and Ubuntu releases that you
want to bootstrap. Consider using the zuul/nodepool-builder docker image
instead as maximum compatibility is attempted there.
By default this element creates the latest LTS release. The exact setting can
be found in the `ubuntu-common <https://docs.openstack.org/diskimage-builder/latest/elements/ubuntu-common/README.html>`_
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.
Semi-automatic doc generation of element dependency Currently there is no description of dependencies in the generated documentation of the elements: therefore a user of an element does not know which other elements are automatically included and e.g. which configuration options are available. In addition there are some copy&pastes of parts of the README.rst scattered thought different Ubuntu and Debian specific elements. This patch adds a semi-automatic generation of dependency information of all elements. Nevertheless these are not automatically included. The author of the element's README.rst can decide if and where the dependency information should appear and can use the descriptor .. element_deps:: for this. This patch adds the dependency information for some Debian and Ubuntu patches - and creates the base for later removing the duplicated parts. A call is added to element_dependencies._find_all_elements() to populate reverse dependencies for Element objects. (This is a reworking of I31d2b6050b6c46fefe37378698e9a330025db430 for the feature/v2 branch) Change-Id: Iebb83916fed71565071246baa550849eef40560b
2017-01-19 21:00:21 +00:00
Install systemd earlier for Ubuntu Bionic Like we did in https://review.openstack.org/475206 we need to install systemd sooner because of the new world order of containers. Change-Id: Ia60d751fee3af6f8d72ad664107acb337360feca Signed-off-by: Paul Belanger <pabelanger@redhat.com>
2018-02-17 18:09:39 +00:00
Note that this element installs ``systemd-sysv`` as the init system for
18.04+.
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-18 17:02:36 +00:00
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.
Add 'DIB_UBUNTU_MIRROR_DISTS' to ubuntu-minimal * Add "DIB_UBUNTU_MIRROR_DISTS": Default: ``updates,security,backports`` Notes: For some deployment, is may be required to disable backport|update|etc packages integration. Change-Id: Ic7dcd29ea658a66763b4422915149e4d3fe663cc
2021-01-26 11:28:47 +00:00
DIB_UBUNTU_MIRROR_DISTS:
:Required: No
:Default: ``updates,security,backports``
:Description: Allow to manage 'dists' repos
:Example: ``DIB_UBUNTU_MIRROR_DISTS=updates,security``
:Notes: For some deployment,
is may be required to disable backport|update|etc packages integration.
Semi-automatic doc generation of element dependency Currently there is no description of dependencies in the generated documentation of the elements: therefore a user of an element does not know which other elements are automatically included and e.g. which configuration options are available. In addition there are some copy&pastes of parts of the README.rst scattered thought different Ubuntu and Debian specific elements. This patch adds a semi-automatic generation of dependency information of all elements. Nevertheless these are not automatically included. The author of the element's README.rst can decide if and where the dependency information should appear and can use the descriptor .. element_deps:: for this. This patch adds the dependency information for some Debian and Ubuntu patches - and creates the base for later removing the duplicated parts. A call is added to element_dependencies._find_all_elements() to populate reverse dependencies for Element objects. (This is a reworking of I31d2b6050b6c46fefe37378698e9a330025db430 for the feature/v2 branch) Change-Id: Iebb83916fed71565071246baa550849eef40560b
2017-01-19 21:00:21 +00:00
.. element_deps::
Reference in New Issue Copy Permalink