Forge Home

puppetserver

Puppet module for puppetserver

61,460 downloads

55,020 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 3.0.1 (latest)
  • 3.0.0
released Sep 7th 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 6.0.0
This module has been deprecated by its author since Jan 5th 2021.

The author has suggested theforeman-puppet as its replacement.

Start using this module

Documentation

puppet/puppetserver — version 3.0.1 Sep 7th 2018

Puppetserver

Puppet Forge Version Puppet Forge Downloads Build Status Puppet Forge Endorsement Gemnasium Donated by Camptocamp

Overview

The puppetserver module allows you to easily manage Puppetserver with Puppet.

Usage

Simple usage

class { 'puppetserver::repository': } ->
class { 'puppetserver': }

Tuning configuration parameters

class { 'puppetserver::repository': } ->
class { 'puppetserver':
  config => {
    'java_args'     => {
      'xms'         => '4g',
      'xmx'         => '6g',
      'maxpermsize' => '512m',
      'tmpdir'      => '/tmp',
    },

    'webserver'  => {
      'ssl-port' => '18140',
    },
  },
}

Classes

puppetserver

The main class to install a Puppet Server.

puppetserver::hiera::eyaml

Install the necessary gems for hiera-eyaml inside the Puppet Server.

Simple usage:

class { '::puppetserver::hiera::eyaml':
  require => Class['puppetserver::install'],
}

Specify eyaml method:

class { '::puppetserver::hiera::eyaml':
  method  => 'gpg',
  require => Class['puppetserver::install'],
}

Definitions

puppetserver::config::java_arg

A setting stored in the JAVA_ARGS variable. Values are managed individually (you don't need to provide all of them);

Example:

puppetserver::config::java_arg { '-Xms':
  value   => '4g',
}

Special note on the tmpdir java_arg. The puppet-server installation requires a tmp dir with a mode of 1777 and a tmp folder which is NOT mounted with the noexec parameter. Otherwise the installation will fail with this strange error message:

Caused by: org.jruby.embed.EvalFailedException: (Error) Cannot determine basic system flavour

For more details, see here.

puppetserver::config::puppetserver

A Puppetserver configuration entry.

Example:

puppetserver::config::puppetserver { 'webserver.conf/webserver/ssl-port':
  value   => '18140',
}

puppetserver::config::bootstrap

A Puppetserver bootstrap.cfg entry.

Example:

puppetserver::config::bootstrap { 'puppetlabs.services.ca.certificate-authority-disabled-service/certificate-authority-disabled-service':
  ensure => present,
}

Providers

puppetserver_gem

This plugin allows to manage gems in the Puppetserver.

Example:

gem { 'hiera-eyaml':
  ensure   => present,
  provider => puppetserver_gem,
}

Contributing

Please report bugs and feature request using GitHub issue tracker.

For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint to follow the recommended Puppet style guidelines from the Puppet Labs style guide.

Transfer Notice

This module was originally authored by Camptocamp. Camptocamp stopped using this module and preferred that Voxpupuli take ownership of the module for future improvement and maintenance. Existing pull requests and issues were transferred over, please fork and continue to contribute here instead of Camptocamp.

Previously: https://github.com/camptocamp/puppet-puppetserver