openstack/diskimage-builder

History

Gregory Haynes 40799839e0 Package installs defaults to tracing off There isn't a good reason we should be defaulting to trace on for these scripts. Change-Id: I1b9ac9388f51a49e6912d800914a0e0f2faec604		2015-12-20 00:03:51 +00:00
..
bin	Merge "package-installs: fix error case for Python 2.6"	2015-05-07 17:25:54 +00:00
extra-data.d	Standarise tracing for scripts	2015-02-12 10:41:32 +11:00
install.d	Package installs defaults to tracing off	2015-12-20 00:03:51 +00:00
post-install.d	Package installs defaults to tracing off	2015-12-20 00:03:51 +00:00
pre-install.d	Package installs defaults to tracing off	2015-12-20 00:03:51 +00:00
element-deps	package-installs for pre-install.d/post-install.d	2014-08-14 21:18:19 -04:00
README.rst	Support arch-specific package-installs	2015-04-24 21:58:05 +00:00

README.rst

package-installs

The package-installs element allows for a declarative method of installing and uninstalling packages for an image build. This is done by creating a package-installs.yaml or package-installs.json file in the element directory.

example package-installs.yaml:

libxml2:
grub2:
  phase: pre-install.d
networkmanager:
  uninstall: True
os-collect-config:
  installtype: source
linux-image-amd64:
  arch: amd64

example package-installs.json:

{
"libxml2": null,
"grub2": {"phase": "pre-install.d"},
"networkmanager": {"uninstall": true}
"os-collect-config": {"installtype": "source"}
}

Setting phase, uninstall, or installtype properties for a package overrides the following default values:

phase: install.d
uninstall: False
installtype: * (Install package for all installtypes)
arch: * (Install package for all architectures)

Setting the installtype property causes the package only to be installed if the specified installtype would be used for the element. See the diskimage-builder docs for more information on installtypes.

Setting the arch property causes the package only to be installed for the specified target architecture. See documentation about the ARCH variable for more information.

DEPRECATED: Adding a file under your elements pre-install.d, install.d, or post-install.d directories called package-installs-<element-name> will cause the list of packages in that file to be installed at the beginning of the respective phase. If the package name in the file starts with a "-", then that package will be removed at the end of the install.d phase.