Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/theforeman/foreman_puppet


https://github.com/theforeman/foreman_puppet

foreman hacktoberfest provisioning puppet

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README

        

# ForemanPuppet

[![Gem Version](https://img.shields.io/gem/v/foreman_puppet.svg)](https://rubygems.org/gems/foreman_puppet)
[![GPL License](https://img.shields.io/github/license/theforeman/foreman_puppet.svg)](https://github.com/theforeman/foreman_puppet/blob/master/LICENSE)

This plugin adds Puppet External node classification functionality to [Foreman](https://theforeman.org).

* Website: [theforeman.org](http://theforeman.org)
* Support: [Foreman support](http://theforeman.org/support.html)

## 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](https://theforeman.org/plugins/#2.Installation)
for how to install Foreman plugins

You can manually install this plugin using:

```sh
# 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](https://github.com/theforeman/foreman_puppet/issues/new)
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 .