0.04
The project is in a healthy, maintained state
Allow assigning Puppet environments and classes to the Foreman Hosts.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

ForemanPuppet

Gem Version GPL License

This plugin adds Puppet External node classification functionality to Foreman.

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 version Plugin version Notes
>= 3.11 ~> 7.0 Required
~> 3.7 - 3.10 ~> 6.0 Required
~> 3.5, 3.6 ~> 5.0 Required
~> 3.4 ~> 4.1 Required
~> 3.3 ~> 4.0 Required
~> 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
dnf install 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) 2020-2024 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/.