Permalink
Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
62 lines (38 sloc) 1.57 KB

Puppet Shell

Overview

This module provides a shell utility for traversing the Puppet Resource Abstraction Layer.

Disclaimer

Warning! While this software is written in the best interest of quality it has not been formally tested by our QA teams. Use at your own risk, but feel free to enjoy and perhaps improve it while you do.

Please see the included Apache Software License for more legal details regarding warranty.

Requirements

So this module was predominantly tested on:

  • Puppet 2.7.12 or greater (faces supported is required)

Other combinations may work, and we are happy to obviously take patches to support other stacks.

Installation

As with most modules, its best to download this module from the forge:

http://forge.puppetlabs.com/puppetlabs/shell

If you want the bleeding edge (and potentially broken) version from github, download the module into your modulepath on your Puppetmaster. If you are not sure where your module path is try this command:

puppet --configprint modulepath

For the shell to work on all the agents, you must enable pluginsync:

[agent]
pluginsync = true

Quick Start

To fire up the shell, use it like so:

# puppet shell
/ > 

At the prompt, the following commands can be used:

  • ls - list all types, or instances of a single type
  • cd - move around types and instances like a file hierarchy
  • cat - view individual resource as puppet code
  • cp - copy a resource to a new name
  • rm - remove a resource
  • edit - convert a resource to text, open it in your editor, and apply the results

Detailed Usage

TBA