Documentation
Puppet-poudriere
Manage the FreeBSD PkgNG build system with Puppet.
Simple Implementation
poudriere::env { "90amd64":
makeopts => [
"WITH_PKGNG=yes",
"OPTIONS_SET+= SASL",
"OPTIONS_SET+= TLS",
"WITH_IPV6=TRUE",
"WITH_SSL=YES",
]
}
nginx::vhost { "build.${domain}":
port => 80,
vhostroot => '/usr/local/poudriere/data/packages',
autoindex => true,
}
@@pkgng::repo { "${::fqdn}-90amd64":
release => '9.0-RELEASE',
mirror_type => 'http',
repopath => '/90amd64-default/Latest/',
}
Changing default settings
The poudriere
class has some default parameters for global settings, such as the ZFS pool, root filesystem, and the FreeBSD mirror site to use (see init.pp
for details). To change these defaults, declare the poudriere
class with your own parameters.
If you do not want to use ZFS, you can use:
class { 'poudriere':
zpool => false,
}
Using port-specific make options
You can pass port-specific make options as a hash in pkg_makeopts
. For instance, if you want to build Apache 2.4 with the PHP 5.5 module, you can do the following:
poudriere::env { "90amd64":
makeopts => [
'WITH_PKGNG=yes',
'APACHE_VERSION=24',
'APACHE_PORT=www/apache24',
],
pkgs => [
'www/apache24',
'lang/php55',
],
pkg_makeopts => {
'lang/php55' => ['OPTIONS_SET+=APACHE'],
},
}
Alternatively, a file containing make options for both global and port-specific use could be defined by setting makefile
.
Using port-specific build options
Ports often allow for enabling or disabling support for certain features. Such options can be manually set by issueing poudriere options cat/port
but can also be defined in puppet by setting pkg_optsdir
. This should point to a directory with files such as could be found in /usr/local/etc/poudriere.d/${jail}-options/
:
poudriere::env { "90amd64":
pkg_optsdir => 'puppet:///path/to/dir/',
}
Managing seperate portstrees
The default
portstreee is no longer configuered by this module. You should create this yourself like so:
poudriere::portstree { 'default': }
poudriere::portstrees:
default:
By default environments use a portstree named default
, which you should create as per the instructions above; however each build environment can be told which portstree to use:
poudriere::portstree { "custom-ports":
cron_enable => false,
fetch_method => 'portsnap',
}
poudriere::env { "custom-build":
portstree => 'custom-ports',
}
poudriere::portstrees:
default:
custom-ports:
cron_enabled: false
fetch_method: portsnap
poudriere::environments:
custom-build:
portstree: custom-ports
Changelog
All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module.
v1.4.0 (2020-04-27)
Merged pull requests:
1.3.0 (2019-12-28)
Merged pull requests:
- Add support for portstree branch #39 (jdmulloy)
- Fix detection of created jails #38 (jdmulloy)
- Fix SAVE_WRKDIR #37 (jdmulloy)
- Update from xaque208 modulesync_config #36 (xaque208)
- Update from xaque208 modulesync_config #35 (xaque208)
1.2.1 (2019-02-27)
Merged pull requests:
1.2.0 (2019-02-02)
Merged pull requests:
1.1.0 (2018-05-27)
Merged pull requests:
1.0.3 (2018-02-11)
Closed issues:
- Still need cron_enable in init.pp manifest #24
Merged pull requests:
1.0.2 (2017-01-28)
Merged pull requests:
1.0.1 (2016-04-04)
Merged pull requests:
1.0.0 (2015-10-19)
Merged pull requests:
0.1.5 (2015-10-08)
Closed issues:
- Symlinks not supported #21
Merged pull requests:
0.1.4 (2015-02-08)
Merged pull requests:
- Update testing #22 (xaque208)
- Syntax fix in README #20 (tbartelmess)
0.1.3 (2014-11-25)
Merged pull requests:
0.1.2 (2014-11-09)
Merged pull requests:
0.1.1 (2014-10-19)
Merged pull requests:
0.1.0 (2014-07-11)
Merged pull requests:
0.0.9 (2014-07-01)
Closed issues:
- latest issue has syntax error #12
- poudriere error: Unknown value for USE_TMPFS #7
- Add support for package options #1
Merged pull requests:
- Cron support #15 (skoef)
- Addtests #14 (xaque208)
- Add tests #13 (xaque208)
- Cron support, example for exporting pkgng repo and some cleaning #11 (skoef)
- make all config file options variables so they can be edited #10 (sethlyons)
- Update tmpfs setting for #7 #8 (xaque208)
- Base Folder/tmpfs #6 (DJClean)
- Add proxy ability #5 (DJClean)
0.0.8 (2014-01-11)
Merged pull requests:
- add support for package-specific make options through pkg_makeopts #4 (lifeforms)
- allow NO_ZFS by setting zpool to false or '' #3 (lifeforms)
- fetch ports by svn: portsnap does not allow non-interactive use #2 (lifeforms)
0.0.7 (2013-02-07)
0.0.6 (2013-02-07)
0.0.5 (2013-02-05)
0.0.4 (2012-12-20)
0.0.1 (2012-10-16)
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 5.0.0 < 7.0.0)