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

35 lines
1.3 KiB
ReStructuredText
Raw 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
Note: The ubuntu element is likely what you want unless you really know
you want this one for some reason. The ubuntu element gets a lot more testing
coverage and use.
Update documented default Ubuntu version Since commit fd5fbdd4b5c15c613133c5a18c8e83b486ec1dd0 xenial is the version used by default. Change-Id: I18e01d806635539b2d6c8a4e6b2d25460647c910
2016-12-21 11:49:27 +00:00
Create a minimal image based on Ubuntu. We default to xenial but DIB_RELEASE
Add minimal ubuntu and centos base elements There are times when a much more stripped down base image is desired over the distro cloud images. For instance, Infra would like some base images that do not have cloud-init or really much of anything else. This is easy to accomplish with debootstrap and rinse. Change-Id: I44ff22457165afb048fdaea469210ae47d83dd3f
2014-11-22 23:46:33 +00:00
is mapped to any series of Ubuntu.
If necessary, a custom apt keyring and debootstrap script can be
Split the debootstrap functions into an element debootstrap is not debian or ubuntu specific. We can make a debootstrap element that knows how to do all of the things, and then a debian-minimal and ubuntu-minimal image that use it. Finally, make the debian element simply be a collection of the extra things we do to make it look like a cloud-init based cloud image. Change-Id: Iaf46c8e61bf1cac9a096cbfd75d6d6a9111b701e
2015-03-22 20:11:55 +00:00
supplied to the `debootstrap` command via `DIB_APT_KEYRING` and
Add minimal ubuntu and centos base elements There are times when a much more stripped down base image is desired over the distro cloud images. For instance, Infra would like some base images that do not have cloud-init or really much of anything else. This is easy to accomplish with debootstrap and rinse. Change-Id: I44ff22457165afb048fdaea469210ae47d83dd3f
2014-11-22 23:46:33 +00:00
`DIB_DEBIAN_DEBOOTSTRAP_SCRIPT` respectively. Both options require the
use of absolute rather than relative paths.
Use of this element will also require the tool 'debootstrap' to be
available on your system. It should be available on Ubuntu, Debian,
and Fedora.
The `DIB_OFFLINE` or more specific `DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE`
variables can be set to prefer the use of a pre-cached root filesystem
tarball.
The `DIB_DEBOOTSTRAP_EXTRA_ARGS` environment variable may be used to
pass extra arguments to the debootstrap command used to create the
base filesystem image. If --keyring is is used in `DIB_DEBOOTSTRAP_EXTRA_ARGS`,
Split the debootstrap functions into an element debootstrap is not debian or ubuntu specific. We can make a debootstrap element that knows how to do all of the things, and then a debian-minimal and ubuntu-minimal image that use it. Finally, make the debian element simply be a collection of the extra things we do to make it look like a cloud-init based cloud image. Change-Id: Iaf46c8e61bf1cac9a096cbfd75d6d6a9111b701e
2015-03-22 20:11:55 +00:00
it will override `DIB_APT_KEYRING` if that is used as well.
Explain difference between two envvars Explain difference between 'DIB_OFFLINE' and 'DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE' Those variables are not redundant,they hava different effective ranges. However,some people may be confused about this and reported a bug. So,this difference should be writen in the README file. Closes-Bug: #1506275 Change-Id: Ie5316de41d129bf98781708954f09ef0b2592b53
2016-07-25 02:15:42 +00:00
For further information about `DIB_DEBIAN_DEBOOTSTRAP_SCRIPT`,
`DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` and `DIB_DEBOOTSTRAP_EXTRA_ARGS`
please consult "README.rst" of the debootstrap element.
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