PUPPET-SCRIPT(8)                 Puppet manual                PUPPET-SCRIPT(8)

NAME
       puppet-script - Run a puppet manifests as a script without compiling a
       catalog

SYNOPSIS
       Runs a puppet language script without compiling a catalog.

USAGE
       puppet script [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose]
       [-e|--execute] [-l|--logdest syslog|eventlog|FILE|console] [--noop]
       file

DESCRIPTION
       This is a standalone puppet script runner tool; use it to run puppet
       code without compiling a catalog.

       When provided with a modulepath, via command line or config file,
       puppet script can load functions, types, tasks and plans from modules.

OPTIONS
       Note that any setting that's valid in the configuration file is also a
       valid long argument. For example, 'environment' is a valid setting, so
       you can specify '--environment mytest' as an argument.

       See the configuration file documentation at
       https://puppet.com/docs/puppet/latest/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.

       --help Print this help message

       --logdest
              Where to send log messages. Choose between 'syslog' (the POSIX
              syslog service), 'eventlog' (the Windows Event Log), 'console',
              or the path to a log file. Defaults to 'console'. Multiple
              destinations can be set using a comma separated list (eg:
              /path/file1,console,/path/file2)"

              A path ending with '.json' will receive structured output in
              JSON format. The log file will not have an ending ']'
              automatically written to it due to the appending nature of
              logging. It must be appended manually to make the content valid
              JSON.

              A path ending with '.jsonl' will receive structured output in
              JSON Lines format.

       --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. Applies to tasks only.

       --execute
              Execute a specific piece of Puppet code

       --verbose
              Print extra information.

EXAMPLE

       $ puppet script -l /tmp/manifest.log manifest.pp
       $ puppet script --modulepath=/root/dev/modules -e 'notice("hello world")'

AUTHOR
       Henrik Lindberg

COPYRIGHT
       Copyright (c) 2017 Puppet Inc., LLC Licensed under the Apache 2.0
       License

Puppet, Inc.                     October 2023                 PUPPET-SCRIPT(8)