GitHub - bloomberg/pepper: A library and stand-alone CLI tools to access a salt-...
source link: https://github.com/bloomberg/pepper
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Pepper
Pepper contains a Python library and CLI scripts for accessing a remote salt-api instance.
pepperlib
abstracts the HTTP calls to salt-api
so existing Python
projects can easily integrate with a remote Salt installation just by
instantiating a class.
The pepper
CLI script allows users to execute Salt commands from computers
that are external to computers running the salt-master
or salt-minion
daemons as though they were running Salt locally. The long-term goal is to add
additional CLI scripts maintain the same interface as Salt's own CLI scripts
(salt
, salt-run
, salt-key
, etc).
It does not require any additional dependencies and runs on Python 2.5+ and Python 3. (Python 3 support is new, please file an issue if you encounter trouble.)
Installation
pip install salt-pepper
Usage
Basic usage is in heavy flux. You can run pepper using the script in %PYTHONHOME%/scripts/pepper (a pepper.cmd wrapper is provided for convenience to Windows users).
export SALTAPI_USER=saltdev SALTAPI_PASS=saltdev SALTAPI_EAUTH=pam pepper '*' test.ping pepper '*' test.kwarg hello=dolly
Examples leveraging the runner client.
pepper --client runner reactor.list pepper --client runner reactor.add event='test/provision/*' reactors='/srv/salt/state/reactor/test-provision.sls'
Configuration
You can configure pepper through the command line, using environment variables
or in a configuration file $HOME/.pepperrc
with the following syntax :
[main] SALTAPI_URL=https://localhost:8000/ SALTAPI_USER=saltdev SALTAPI_PASS=saltdev SALTAPI_EAUTH=pam
Contributing
Please feel free to get involved by sending pull requests or join us on the Salt mailing list or on IRC in #salt or #salt-devel.
This repo follows the same contributing guidelines as Salt and uses separate develop and master branches for in-progress additions and bug-fix changes respectively.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK