A CLI front-end to a running salt-api system
Project description
Cumin contains a Python library and CLI scripts for accessing a remote salt-api instance.
cumin 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 cumin 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).
Installation
pip install salt-cumin
Usage
export SALTAPI_USER=saltdev SALTAPI_PASS=saltdev SALTAPI_EAUTH=pam
cumin '*' test.ping
cumin '*' test.kwarg hello=dolly
Examples leveraging the runner client.
cumin-run reactor.list
cumin-run reactor.add event='test/provision/*' reactors='/srv/salt/state/reactor/test-provision.sls'
Configuration
You can configure cumin 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for salt_cumin-0.6.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2fb7810f106df8042bea4bd3edba1b9168fe6af63b338bb3eb0d08968aac1ab3 |
|
MD5 | bfc66d6a8093c9702a7575b514e6bb7e |
|
BLAKE2b-256 | 9c239fee2a11b0c6cccee05a9263446d5c4b9bab1d9cbf01e8dc15c90bb4c7e6 |