ForemanPuppet
This plugin adds Puppet External node classification functionality to Foreman.
- Website: theforeman.org
- Support: Foreman support
Features
- Puppet dashboards
- Puppet
- Environments
- Classes
- Config groups
- Smart Class parameters
- Host / Hostgroup
- Classes assignment
- Environment assignment
- Puppet proxy assignment
- Puppet ENC (external node classifier)
- Smartproxy Puppet status/tab
- Template hostgroup / environment
Some features will remain in core:
- PuppetCA
- Report/Fact parsing
Compatibility
Foreman 3.0 will be the first release where the Puppet functionality is mostly extracted. Therefore, this plugin is only required for 3.0 and onwards. You can install it on Foreman 2.5 to prepare for the Foreman update.
| Foreman version | Plugin version | Notes |
|---|---|---|
| >= 3.2 | ~> 3.0 | Required |
| ~> 3.1 | ~> 2.0 | Required |
| ~> 3.0 | ~> 1.0 | Required |
| >= 2.5 | ~> 0.1 | Optional; replaces Core features |
| < 2.5 | - | Not supported (functionality is in Core) |
Installation
See How_to_Install_a_Plugin for how to install Foreman plugins
You can manually install this plugin using:
# On RedHat/CentOS
yum install tfm-rubygem-foreman_puppet
# On Debian
apt install ruby-foreman-puppet
Usage
The usage is identical to the prior core functionality:
- Import environments and classes from a Smartproxy
- Optionally define Smart Class parameters
- Assign environment and classes to Hosts / Hostgroups
- Use the Puppet ENC on your Puppetserver(s) to query Foreman
Problems
Please feel free to open a new Github issue if you encounter any bugs/issues using this plugin.
Contributing
Fork and send a Pull Request. Thanks!
Copyright
Copyright (c) 2021 The Foreman developers
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.