NAME¶
puppet-apply - Apply Puppet manifests locally
SYNOPSIS¶
Applies a standalone Puppet manifest to the local system.
USAGE¶
puppet apply [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose]
[-e|--execute] [--detailed-exitcodes] [-l|--logdest
file] [--noop]
[--catalog
catalog]
file
DESCRIPTION¶
This is the standalone puppet execution tool; use it to apply individual
manifests.
When provided with a modulepath, via command line or config file, puppet apply
can effectively mimic the catalog that would be served by puppet master with
access to the same modules, although there are some subtle differences. When
combined with scheduling and an automated system for pushing manifests, this
can be used to implement a serverless Puppet site.
Most users should use ´puppet agent´ and ´puppet master´ for
site-wide manifests.
OPTIONS¶
Note that any configuration parameter that´s valid in the configuration
file is also a valid long argument. For example, ´tags´ is a valid
configuration parameter, so you can specify ´--tags
class,
tag´ as an argument.
See the configuration file documentation at
http://docs.puppetlabs.com/references/stable/configuration.html for the full
list of acceptable parameters. A commented list of all configuration options
can also be generated by running puppet with ´--genconfig´.
- --debug
- Enable full debugging.
- --detailed-exitcodes
- Provide transaction information via exit codes. If this is
enabled, an exit code of ´2´ means there were changes, an exit
code of ´4´ means there were failures during the transaction,
and an exit code of ´6´ means there were both changes and
failures.
- --help
- Print this help message
- --loadclasses
- Load any stored classes. ´puppet agent´ caches
configured classes (usually at /etc/puppet/classes.txt), and setting this
option causes all of those classes to be set in your puppet manifest.
- --logdest
- Where to send messages. Choose between syslog, the console,
and a log file. Defaults to sending messages to the console.
- --noop
- Use ´noop´ mode where Puppet runs in a no-op or
dry-run mode. This is useful for seeing what changes Puppet will make
without actually executing the changes.
- --execute
- Execute a specific piece of Puppet code
- --verbose
- Print extra information.
- --catalog
- Apply a JSON catalog (such as one generated with
´puppet master --compile´). You can either specify a JSON file
or pipe in JSON from standard input.
EXAMPLE¶
$ puppet apply -l /tmp/manifest.log manifest.pp
$ puppet apply --modulepath=/root/dev/modules -e "include ntpd::server"
$ puppet apply --catalog catalog.json
AUTHOR¶
Luke Kanies
COPYRIGHT¶
Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License