Version information
This version is compatible with:
- Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 4.0.0 < 5.0.0
This module has been deprecated by its author since Jun 15th 2021.
The author has suggested puppet-jail as its replacement.
Start using this module
Documentation
FreeBSD Jail management with Puppet
Manage FreeBSD jails with Puppet, leveraging iocage for jail management.
Setup
This module expects to be the only jail manager on a given system. Each system where jails will be managed needs to include the jail::setup class as well.
include jail::setup
This simply installs 'iocage' and removes '/etc/jail.conf'.
This allows the type to use the correct jail without having to specify the pool on each jail.
A simple jail
jail { 'myjail1':
ensure => present,
state => 'up',
ip4_addr => 'em0|10.0.0.10/24',
ip6_addr => 'em0|fc00::10/64',
hostname => 'myjail1.example.com',
boot => 'on',
user_data => template('mysite/user_data.sh.erb'),
}
Note the ip4_addr and the ip6_addr properties take an interface name and an IP address separated by a pipe character. This value is passed directly to iocage(7). You may wish to read the man page.
Types in this module release
Unreleased
2018-06-02 4.0.0
Summary
A significant update to the module. Please see the readme for change details.
- Modulesync for deployment updates
- Add design doc for where to keep the conversation about approach
- Replace iocage.sh provider with iocage.py provider
- Moved iocage.sh provider to iocage_legacy name
- Add new properties
2016-08-29 3.1.0
Summary
Drop old puppet versions, add tests for existing functionality.
2016-07-27 3.0.0
Summary
Drop legacy code and add new zfs properties.
Features
- Add ZFS properties
- Drop legacy jail provider
2016-05-31 2.1.1
Summary
Changes to testing dependencies.
Testing
- Drop guard from the Gemfile
A feature release.
2016-05-31 2.1.0
Summary
A feature release.
Features
- Add user_data support for first boot script
2016-04-25 2.0.9
Summary
This release adds a changelog.
Features
- Add a changelog
2016-04-22 2.0.8
Summary
This is a bugfix release.
Bugfixes
- Handl the order of the iocage service and package correctly
2016-04-04 2.0.7
Summary
This is a testing release.
Testing
- Update tests to include puppet4
2016-03-08 2.0.6
Summary
This is a bugfix release to avoid starting the iocage service.
Bugfixes
- Only enable the service as there is no daemon
2016-03-08 2.0.5
Summary
This is a feature release to include iocage service management.
Features
- Manage the iocage service
2016-02-21 2.0.4
Summary
This is a bugfix release.
Bugfixes
- Fix regex match more complex hostnames and add test
2015-11-28 2.0.3
Summary
This is a bugfix release to address property handling.
Bugfixes
- Set jail properties upon creation before boot
2015-10-19 2.0.2
Summary
This is a bugfix release.
Bugfixes
- Fix regex to include JIDs that begin with '1' and add test
2015-09-08 2.0.1
Summary
This is a bugfix release.
Bugfixes
- Add regex matching for discovering only iocage created jails
- Fix boot parameter in documentation
2015-08-16 2.0.0
Summary
This is a backwards incompatible release to support a new jail management utility framework called iocage(8).
Features
- Add new provider for iocage with basic tests
- Adjust type parameters to match iocage nomenclature
2015-08-16 1.0.0
Summary
This release is the first major release of the jail module, containing a minimal pattern of creating ZFS based jails using a puppet type and provider.
Features
- Initial type and provider for managing ZFS based jails
Dependencies
- puppetlabs/concat (>= 1.1.0 <= 5.0.0)