Forge Home

install_noop

Tasks to install a Puppet Enterprise agent in 'noop' mode on Linux or Windows.

5,709 downloads

4,496 latest version

4.5 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

  • 1.0.3 (latest)
  • 1.0.2
  • 1.0.1
  • 1.0.0
released Dec 31st 2018
This version is compatible with:
  • Puppet Enterprise >= 3.8
  • , , , ,
Tasks:
  • linux
  • linux_postsign
  • windows
  • windows_postsign

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'gabe-install_noop', '1.0.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add gabe-install_noop
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install gabe-install_noop --version 1.0.3

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

gabe/install_noop — version 1.0.3 Dec 31st 2018

install_noop

Sometimes you want to install a Puppet Enterprise agent on some nodes, but you're too afraid to let it actually manage anything yet. In these cases you might install it and set "noop=true" in the puppet.conf before its first run. That way it's running, its facts and reports are getting stored in PuppetDB, but it's really only reporting on what it would change if you gave it the chance to do its job.

These Bolt tasks automate the job. Briefly, they:

  1. Fetch the installer script from a master,
  2. Run the installer, but tell it to add "noop=true" to the puppet.conf before starting Puppet,
  3. Try a limited run of the agent, only applying "puppet_enterprise" classes, and
  4. Start up the Puppet (in noop mode) and PXP-Agent services

With Autosigning (one-step)

If you have autosigning enabled on your master, these tasks will have your agent up and running in one fell swoop.

  • Puppet agent running,
  • Puppet execution protocol configured, and
  • Puppet execution protocol running.

Installing an agent in noop mode is as simple as, for example:

bolt task run install_noop::linux master=kermit.puppetlabs.vm \
  --no-host-key-check --user root --password \
  --nodes ssh://waldorf,ssh://statler

Or an example for Windows:

bolt task run install_noop::windows master=kermit.puppetlabs.vm \
  --no-ssl --user Administrator --password \
  --nodes winrm://rizzo

For more information on Bolt's configuration and command-line options, refer to the Bolt online documentation.

Without Autosigning (two-step)

If you don't have autosigning enabled on your master, you will need to do a two-step process.

  1. Run install_noop::linux or install_noop::windows on nodes,
  2. Sign the new nodes' certificates, and
  3. Run install_noop::linux_postsign or install_noop::windows_postsign.

For instance, the whole process on Linux:

# Install the agent on the node, in "noop" mode:
bolt task run install_noop::linux master=kermit.puppetlabs.vm \
  --no-host-key-check --user root --password \
  --nodes ssh://waldorf,ssh://statler
#
# Sign the node's certificate on the master
#
# Run the agent in a limited fashion, to finish configuring it:
bolt task run install_noop::linux_postsign \
  --no-host-key-check --user root --password \
  --nodes ssh://waldorf,ssh://statler

Limitations

  • This task can only install Puppet Enterprise, fetching from a Puppet Enterprise master.
  • The methodology here has not been rigorously tested -- but it has been field tested in a handful of environments.
  • Your master must be classified with the proper pe_repo classes for each platform you wish to install to.