Forge Home


Allows remote running of puppet agents with up to two --tags


4,015 latest version

5.0 quality score

Version information

  • 1.0.0 (latest)
  • 0.1.0
released Apr 8th 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 7.0.0
  • , , , , , , , ,
  • agent_run_tags

Start using this module

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

Add this module to your Puppetfile:

mod 'martyewings-agent_run_with_tags', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add martyewings-agent_run_with_tags
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install martyewings-agent_run_with_tags --version 1.0.0

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.



martyewings/agent_run_with_tags — version 1.0.0 Apr 8th 2019


Table of Contents

  1. Description
  2. Setup - The basics of getting started with agent_run_with_tags
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


The Task in this module fills a hole in orchestrators native abilities. It allows you to run puppet agent with the --tags options on linux nodes running a bash shell.

By default it requires just one tag to be passed as an option, it allows up to 2. there are also 2 additional optional parameters param1 and param2 which can be used to pass standard puppet agent flags, such as --noop or --debug


Beginning with agent_run_with_tags

Install the module, the tasks will be populated in the tasks dropdown in the PE console


This task can be run against any linux node with a bash shell, it has 4 parameters:

tag1 - mandatory the tag you want to run the agent run with tag2 - an optional second tag param1 - an optional param that can be used to pass any agent flag, valid options include --debug --noop --fingerprint param2 - a second optional parameter incase one is not enough



restricted to use on linux platforms with a bash shell