diskimage-builder/diskimage_builder/elements/ubuntu/README.rst

======
ubuntu
======

Use Ubuntu cloud images as the baseline for built disk images.

Overrides:

 * To use a non-default URL for downloading base Ubuntu cloud images,
   use the environment variable ``DIB_CLOUD_IMAGES``
 * To download a non-default release of Ubuntu cloud images, use the
   environment variable ``DIB_RELEASE``. This element will export the
   ``DIB_RELEASE`` variable.
 * Use ``DIB_DISTRIBUTION_MIRROR`` to override the ``sources.list``
   with an alternative mirror
 * Setting ``DIB_DISTRIBUTION_MIRROR_UBUNTU_IGNORE`` to an
   extended-regexp (i.e. the argument to the ``=~`` bash comparitor)
   which, when matched, will *not* set that line to the
   ``DIB_DISTRIBUTION_MIRROR``.  For example, if your local mirror
   does not mirror the universe and multiverse components, set this to
   ``(universe|multiverse)``
 * Setting ``DIB_DISTRIBUTION_MIRROR_UBUNTU_INSECURE`` updates apt
   settings to allow insecure/unuthenticated repositories.

.. element_deps::
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`
			`======`

Move initial root contents into a hook. This is a necessary but not complete step towards supporting Fedora and Suse distributions. Further work is needed (e.g. to quiesce daemons on installation). Change-Id: If3ea6093d41a21de755db52328226b84b5a3ede6 2013-02-11 04:01:36 +00:00			`Use Ubuntu cloud images as the baseline for built disk images.`
Migrate cloud image URL/Release options to DIB_. This switches $CLOUD_IMAGES and $RELEASE to the DIB_ namespace so they will survive future changes to the sanitisation of the build environment. Change-Id: I7dc2aa82fb9ef452705b080cc404f41046014f20 2013-04-12 13:41:32 +00:00
			`Overrides:`

			`* To use a non-default URL for downloading base Ubuntu cloud images,`
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			use the environment variable ``DIB_CLOUD_IMAGES``
Migrate cloud image URL/Release options to DIB_. This switches $CLOUD_IMAGES and $RELEASE to the DIB_ namespace so they will survive future changes to the sanitisation of the build environment. Change-Id: I7dc2aa82fb9ef452705b080cc404f41046014f20 2013-04-12 13:41:32 +00:00			`* To download a non-default release of Ubuntu cloud images, use the`
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			environment variable ``DIB_RELEASE``. This element will export the
			``DIB_RELEASE`` variable.
ubuntu: Add options to ignore mirror components and use insecure repos When using the upstream cloud images with the "ubuntu" element, they have universe and multiverse enabled which we don't mirror. To use the infra mirrors as a DIB_DISTRIBUTION_MIRROR with this element, we need to be able to skip redirecting to universe and multiverse, and additionally enable insecure repos (as we don't gpg sign our mirrors). Add and document two new variables with the ubuntu element to do this. This is then setup by the openstack-ci-mirrors element so that we use local mirrors duing dib functional testing for the "ubuntu" element. Change-Id: I6ffbde07fa0e103641ee5c5f9d9e854e5b2168dc 2018-10-15 05:00:18 +00:00			* Use ``DIB_DISTRIBUTION_MIRROR`` to override the ``sources.list``
			`with an alternative mirror`
			* Setting ``DIB_DISTRIBUTION_MIRROR_UBUNTU_IGNORE`` to an
			extended-regexp (i.e. the argument to the ``=~`` bash comparitor)
			`which, when matched, will not set that line to the`
			``DIB_DISTRIBUTION_MIRROR``. For example, if your local mirror
			`does not mirror the universe and multiverse components, set this to`
			``(universe\|multiverse)``
			* Setting ``DIB_DISTRIBUTION_MIRROR_UBUNTU_INSECURE`` updates apt
			`settings to allow insecure/unuthenticated repositories.`
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::`