trigger.contrib
— Extra, optional tools that solve common problems, extend, or modify core functionality.¶
trigger.contrib.commando¶
Simple command running for Trigger meant to be used with a long-running reactor loop (such using the Twisted XMLRPC server).
This differs from Commando
in that:
- It does not start/stop the reactor, instead it uses sentinel values and a task monitor to detect when it’s done.
- The
.run()
method returns atwisted.internet.defer.Deferred
object. - Results/errors are stored in a list instead of a dict.
- Each result object is meant to be easily serialized (e.g. to JSON).
-
class
trigger.contrib.commando.
CommandoApplication
(*args, **kwargs)¶ Commando subclass to be used in an application where the reactor is always running (e.g. twistd or an application server).
Stores results as a list of dictionaries ideal for serializing to JSON.
-
device_object
(device_name, **kwargs)¶ Create a basic device dictionary with optional data.
-
from_base
(results, device, commands=None)¶ Call store_results directly
-
from_juniper
(results, device, commands=None)¶ (Maybe) convert Juniper XML results into a strings
-
map_results
(commands=None, results=None)¶ Return a list of command objects.
[{‘command’: ‘foo’, ‘result’: ‘bar’}, …]
-
monitor_result
(result, reactor)¶ Loop periodically or until the factory stops to monitor the results and return them.
-
run
()¶ Nothing happens until you execute this to perform the actual work.
-
store_error
(device, error)¶ Called when an errback is fired.
Should do somethign meaningful with the errors, but for now just stores it as it would a result.
-
trigger.contrib.commando.plugins¶
This package provides facilities for running commands on devices using the CLI. Plugins for the Commando API built around Trigger.
trigger.contrib.docommand¶
This package provides facilities for running commands on devices using the CLI.
-
class
trigger.contrib.docommand.
DoCommandBase
(devices=None, commands=None, creds=None, incremental=None, max_conns=10, verbose=False, timeout=30, production_only=True, allow_fallback=True, with_errors=True, force_cli=False, with_acls=False, command_interval=0, stop_reactor=True)¶ Base class for docommand action classes.
-
errback
(failure, device)¶ The default errback. Overload for custom behavior but make sure it always decrements the connections.
Parameters: - failure – Usually a Twisted
Failure
instance. - device – A
NetDevice
object
- failure – Usually a Twisted
-
from_base
(results, device, commands=None)¶ Call store_results without calling map_results
-
-
class
trigger.contrib.docommand.
CommandRunner
(files=None, commands=None, debug=False, timeout=30, **kwargs)¶ Run commands on network devices.
Usage:
n = CommandRunner(devices=['dev1', dev2'], files=['file1', 'file2']) n.run()
This will execute all commands inside of each file (‘file1’,’file2’) onto all listed devices (‘dev1, ‘dev2’).
Parameters: - devices – List of device names. Each hostname must have a match in NetDevices.
- files – List of files named after the FQDN of each device.
-
store_results
(device, results)¶ Define how we’re storing results.
-
class
trigger.contrib.docommand.
ConfigLoader
(files=None, commands=None, debug=False, **kwargs)¶ Load configuration changes on network devices.
Usage:
n = ConfigLoader(devices=['dev1', dev2'], files=['file1', 'file2']) n.run()
This will load all listed config files (‘file1’,’file2’) onto all listed devices (‘dev1, ‘dev2’).
Parameters: files – List of files named after the FQDN of each device.
- Files must exist in a local TFTP directory for non-Juniper devices.
- Files must be accessible by device via TFTP for non-Juniper devices.
-
from_juniper
(data, device, commands=None)¶ Parse results from a Juniper device.
-
store_results
(device, results)¶ Store the results from a commands.
If you’d rather just change the default method for storing results, overload this. All default parse/generate methods call this.
-
to_juniper
(device=None, commands=None, extra=None)¶ Configure a Juniper device using JunoScript.
Returns: list
-
trigger.contrib.docommand.
xml_print
(xml, iterations=10)¶ Display XML in a tree format.
Parameters: - xml – XML object to parse
- iterations – Number of iterations to perform
-
trigger.contrib.docommand.
do_work
(work=None, action_class=None)¶ list results = do_work(list work)
-
trigger.contrib.docommand.
get_commands_from_opts
(opts)¶ list commands = get_commands_from_opts(dict opts)
User specified on cmdline either a path to a file containing a list of commands/config or an actual list. Return the list!
-
trigger.contrib.docommand.
get_devices_from_opts
(opts)¶ list devicenames = get_devices_from_opts(dict opts)
User specified on cmdline either a path to a file containing a list of devices or an actual list. Return the list!
-
trigger.contrib.docommand.
get_devices_from_path
(path)¶ list devicenames = get_devices_from_path(str path)
If path specified for devices/configs, then the list of filenames in dir will correspond to the list of devices.
The contents of each file contain the config/commands to be loaded/run on the specific device.
Future enhancements
- verify that the filenames are fqdns
- verify that the devnames exist in netdevices.xml
-
trigger.contrib.docommand.
get_jobs
(opts)¶ list jobs = get_jobs(dict opts)
Based on which arguments are provided, figure out what is loaded/run on which devices and create a list of objects matching the 2:
job = {'d': [],'c': [],'f': []}
Is read as “load ALL configs listed in ‘c’ on ALL devs listed in ‘d’”. Each such grouping is a separate job.
Future enhancements:
- If multiple jobs exist for the same device we should regroup and optimize biggest optimization, though, will come after minor Commando enhancements would allow feeding entire list into a single run()
-
trigger.contrib.docommand.
get_list_from_file
(path)¶ list text = get_list_from_file(str path)
Specified file (path) will contain a list of newline-separated items. This function is used for loading both configs/cmds as well as devices.
-
trigger.contrib.docommand.
main
(action_class=None)¶ void = main(CommandoClass action_class)
-
trigger.contrib.docommand.
print_results
(results=None)¶ binary success = print_results(list results)
-
trigger.contrib.docommand.
print_work
(work=None)¶ void = do_work(list work)
Cycle through the list of jobs and then display the work to be done.
-
trigger.contrib.docommand.
stage_tftp
(acls, nonce)¶ Need to edit this for cmds, not just acls, but the basic idea is borrowed from
bin/load_acl
.
-
trigger.contrib.docommand.
verify_opts
(opts)¶ Validate opts and return whether they are ok.
returns True if all is good, otherwise (False, errormsg)
trigger.contrib.xmlrpc¶
XMLRPC Server for Trigger with SSH manhole service.
Trigger Twisted XMLRPC server with an SSH manhole. Supports SSL.
This provides a daemonized Twisted reactor loop, Trigger and client applications do not have to co-habitate. Using the XMLRPC server model, all Trigger compatibility tasks can be executed using simple XMLRPC clients that call the appropriate method with arguments on the local XMLRPC server instance.
New methods can be added by way of plugins.
See examples/xmlrpc_server
in the Trigger source distribution for a simple
usage example.
-
class
trigger.contrib.xmlrpc.server.
TriggerXMLRPCServer
(*args, **kwargs)¶ Twisted XMLRPC server front-end for Commando
-
addHandler
(handler)¶ Add a handler and bind it to an XMLRPC procedure.
Handler must a be a function or an instance of an object with handler methods.
-
addHandlers
(handlers)¶ Add multiple handlers
-
listProcedures
()¶ Return a list of the registered procedures
-
lookupProcedure
(procedurePath)¶ Lookup a method dynamically.
- First, see if it’s provided by a sub-handler.
- Or try a self-defined method (prefixed with
xmlrpc_
) - Lastly, try dynamically mapped methods.
- Or fail loudly.
-
xmlrpc_add
(x, y)¶ Adds x and y
-
xmlrpc_add_handler
(mod_name, task_name, force=False)¶ Add a handler object from a remote call.
-
xmlrpc_execute_commands
(args, kwargs)¶ Execute
commands
ondevices
-
xmlrpc_fault
()¶ Raise a Fault indicating that the procedure should not be used.
-
-
trigger.contrib.xmlrpc.server.
main
()¶ To daemonize as a twistd plugin! Except this doesn’t work and these