Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Python Module that parses salt returns stored in an external job cache and logs output

Project Description

salt-nanny

Python Module that parses salt returns stored in redis and logs output

Example Usage:

Command Line Usage:

salt-nanny localhost minion1 minion2

Look for salt returns in localhost for minions - minion1 & minion2

salt-nanny localhost minion1 minion2 -p 6380 -x 20 -I 5 60 2

This command tells salt-nanny to wait 5, 10, 20, 40 and 60 seconds between each retry initially and then 60s for subsequent retries. Attempt 20 times and then give up. Use port 6380 for redis.

Example Python code:

#!/usr/bin/env python
import salt.client
from saltnanny import SaltNanny

# Initialize SaltNanny with the cache & salt function
config = {'type': 'redis', 'host':'localhost', 'port':6379, 'db':'0'}
nanny = SaltNanny(config, 'test', 'state.highstate')

# Use SaltNanny to track returns to the external job cache
salt_nanny.initialize(['minion1', 'minion2'])
salt_nanny.track_returns()
return_code = salt_nanny.process_returns()
  • For the example above, the log file in logs/test-state.highstate.log will contain results of the salt highstate
  • The return code is 0 if all the salt functions for all minions succeded with a return dict containing retcode:0.
  • SaltNanny also checks state results in case of a highstate. If any one state fails, the retcode is non zero.

Release Notes

v0.1.1 First working versionn v0.1.2 Make changes in redis key structure for salt 2016 compatibilityn v0.1.3 Fix bug when reading the redis returnn v0.1.4 Add facility to read the last redis return without tracking a currently running highstate.n v0.1.5 Fix formatting of log message.n v0.1.6 Add salt-nanny command line utility to track returns from running highstate.n v0.1.7 Update Documentation & improve command line utilityn v0.1.9 Fixed bug to return exit code 2 if no returns are found. v0.2.0 Added new command line parameter(earliest_jid) to only return saltmaster results more recent than the passed jid

Release History

Release History

This version
History Node

0.2.0

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.0.2

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
saltnanny-0.2.0.tar.gz (7.1 kB) Copy SHA256 Checksum SHA256 Source Sep 14, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting