salt.runners.sdb¶

Runner for setting and querying data via the sdb API on the master

salt.runners.sdb.delete(uri)¶

Delete a value from a db, using a uri in the form of sdb://<profile>/<key>. If the uri provided does not start with sdb:// or the value is not successfully deleted, return False.

CLI Example:

salt-run sdb.delete sdb://mymemcached/foo

salt.runners.sdb.get(uri)¶

Get a value from a db, using a uri in the form of sdb://<profile>/<key>. If the uri provided does not start with sdb://, then it will be returned as-is.

CLI Example:

salt-run sdb.get sdb://mymemcached/foo

salt.runners.sdb.get_or_set_hash(uri, length=8, chars='abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_=+)')¶

Perform a one-time generation of a hash and write it to sdb. If that value has already been set return the value instead.

This is useful for generating passwords or keys that are specific to multiple minions that need to be stored somewhere centrally.

CLI Example:

salt-run sdb.get_or_set_hash 'SECRET_KEY' 50

Warning

This function could return strings which may contain characters which are reserved as directives by the YAML parser, such as strings beginning with %. To avoid issues when using the output of this function in an SLS file containing YAML+Jinja, surround the call with single quotes.

salt.runners.sdb.set_(uri, value)¶

Set a value in a db, using a uri in the form of sdb://<profile>/<key>. If the uri provided does not start with sdb:// or the value is not successfully set, return False.

CLI Example:

salt-run sdb.set sdb://mymemcached/foo bar