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

59 lines
2.5 KiB
ReStructuredText
Raw Normal View History

Initial add of gentoo support for diskimage-builder uses upstream's stage4 images, includes all the needed bells and whistles for openstack on kvm. Change-Id: Ibca43173c30c2a74a73a2e2d9dd6d6d832c62694 Closes-Bug: 1530911
2016-01-04 17:00:28 +00:00
========
Gentoo
========
Use a Gentoo cloud image as the baseline for built disk images. The images are
located in profile specific sub directories:
http://distfiles.gentoo.org/releases/amd64/autobuilds/
As of this writing, only x86_64 images are available.
Notes:
* There are very frequently new automated builds that include changes that
happen during the product maintenance. The download directories contain an
unversioned name and a versioned name. The unversioned name will always
Note requirement for parted on gentoo hosts The vm element makes use of parted. In order to create partitions parted needs to be installed, growroot does not work without partitions. Change-Id: Ib46cb818e0116f050de01f9a19e6041328d6d478
2016-03-20 03:04:05 +00:00
point to the latest image, but will frequently change its content. The
versioned one will never change content, but will frequently be deleted and
replaced by a newer build with a higher version-release number.
Initial add of gentoo support for diskimage-builder uses upstream's stage4 images, includes all the needed bells and whistles for openstack on kvm. Change-Id: Ibca43173c30c2a74a73a2e2d9dd6d6d832c62694 Closes-Bug: 1530911
2016-01-04 17:00:28 +00:00
Add Gentoo to the list of supported distributions We also document any additional package needed. Change-Id: I7b9193fa5711138287f587935fc864fee4f95856
2016-02-18 16:57:07 +00:00
* In order to run the package-installs element you will need to make sure
`dev-python/pyyaml` is installed on the host.
Note requirement for parted on gentoo hosts The vm element makes use of parted. In order to create partitions parted needs to be installed, growroot does not work without partitions. Change-Id: Ib46cb818e0116f050de01f9a19e6041328d6d478
2016-03-20 03:04:05 +00:00
* In order to run the vm element you will need to make sure `sys-block/parted`
is installed on the host.
Initial add of gentoo support for diskimage-builder uses upstream's stage4 images, includes all the needed bells and whistles for openstack on kvm. Change-Id: Ibca43173c30c2a74a73a2e2d9dd6d6d832c62694 Closes-Bug: 1530911
2016-01-04 17:00:28 +00:00
* Other profiles can be used by exporting GENTOO_PROFILE with a valid profile.
A list of valid profiles follows:
update gentoo vars for new profile and python Change-Id: I810b09f98c479e6ebdbf8de6fae31166a3e87667
2018-02-12 16:36:03 +00:00
default/linux/amd64/17.0
default/linux/amd64/17.0/no-multilib
update Gentoo Hardened profiles (now stable) Change-Id: I6d89f27bfd62fc0e86fec1a0bc6cb37f9ec6c82f Signed-off-by: Matthew Thode <mthode@mthode.org>
2018-02-21 17:06:16 +00:00
default/linux/amd64/17.0/hardened
default/linux/amd64/17.0/no-multilib/hardened
enable caching for gentoo builds To facilitate this I've created two new environment variables to set the environment and default options for package actions. eval is needed for the export as it preserves quotes. Change-Id: Ib03651ee8dacd48cd1c135afd57cd31101356056 Signed-off-by: Matthew Thode <mthode@mthode.org>
2018-10-08 05:39:35 +00:00
default/linux/amd64/17.0/systemd
Optionally remove portage files Optionally remove portage files, so that we can cache package and keep the portage directory around, specifically for nodepool. This also adds a section to the Gentoo readme about the variable and renames the 00-gentoo-distro-name environment file to a more appropriate name of 00-gentoo-envars. Also brought up was the location of the gentoo-releng.gpg file, this has been moved and the refrencing paths updated. Change-Id: I20c91b36082828faa1ca481585acc5f9933211e1
2016-07-28 20:11:43 +00:00
enable caching for gentoo builds To facilitate this I've created two new environment variables to set the environment and default options for package actions. eval is needed for the export as it preserves quotes. Change-Id: Ib03651ee8dacd48cd1c135afd57cd31101356056 Signed-off-by: Matthew Thode <mthode@mthode.org>
2018-10-08 05:39:35 +00:00
* You can set the `GENTOO_PORTAGE_CLEANUP` environment variable to False to
disable the clean up of portage repositories (including overlays). This
will make the image bigger if caching is also disabled.
Update Gentoo element for element changes There have been a few changes over the past few months, here we make the following changes. * change from backtrack=99 to complete-graph as a more correct flag * make python version selection more in line with what gentoo supports * set up python before stuff gets pip installed * ensure we have the proper pip so we can install pip packages as root * ensure we have the proper use flags for the disk formatting changes * set DIB_RELEASE like other distros * fix openssh-server element for gentoo Change-Id: I17202de3016616ce34c8cbead7d0fb047a64e96b
2017-09-13 21:57:12 +00:00
enable caching for gentoo builds To facilitate this I've created two new environment variables to set the environment and default options for package actions. eval is needed for the export as it preserves quotes. Change-Id: Ib03651ee8dacd48cd1c135afd57cd31101356056 Signed-off-by: Matthew Thode <mthode@mthode.org>
2018-10-08 05:39:35 +00:00
* Gentoo supports many different versions of python, in order to select one
Update Gentoo element for element changes There have been a few changes over the past few months, here we make the following changes. * change from backtrack=99 to complete-graph as a more correct flag * make python version selection more in line with what gentoo supports * set up python before stuff gets pip installed * ensure we have the proper pip so we can install pip packages as root * ensure we have the proper use flags for the disk formatting changes * set DIB_RELEASE like other distros * fix openssh-server element for gentoo Change-Id: I17202de3016616ce34c8cbead7d0fb047a64e96b
2017-09-13 21:57:12 +00:00
you may use the `GENTOO_PYTHON_TARGETS` environment variable to select
the versions of python you want on your image. The format of this variable
is a string as follows `"python2_7 python3_5"`.
* In addition you can select the primary python version you wish to use (that
which will be called by running the `python` command. The
`GENTOO_PYTHON_ACTIVE_VERSION` is used to set that mapping. The variable
contents can be something like `python3.5`.
Enable support for Gentoo overlays This is intended to eventually support building musl-libc based images, which need the musl overlay. Change-Id: I8f5429ffa64e74c860772d9a00ff0b7eebb7721a
2017-11-01 03:04:29 +00:00
* You can enable overlays using the `GENTOO_OVERLAYS` variable. In it you
should put a space separated list of overlays. The overlays must be in the
official overlay list and must be git based.
enable caching for gentoo builds To facilitate this I've created two new environment variables to set the environment and default options for package actions. eval is needed for the export as it preserves quotes. Change-Id: Ib03651ee8dacd48cd1c135afd57cd31101356056 Signed-off-by: Matthew Thode <mthode@mthode.org>
2018-10-08 05:39:35 +00:00
* `GENTOO_EMERGE_ENV` is a bash array containing default environment
variables for package install, you can override it with another bash array.
* `GENTOO_EMERGE_DEFAULT_OPTS` can be set to control the default options
passed to emerge for all package actions, this includes operations like
depclean and preserved-rebuild.
Reference in New Issue Copy Permalink