Skip to content

theforeman/foreman_puppet

Repository files navigation

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.13 ~> 8.0 Required
~> 3.11, 3.12 ~> 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/.