Run a single SLS file locally with Salt, without the need for a master or minion setup. This agentless and simplified approach allows faster deployment and testing of SLS files.
About
salt-sls is an innovation for those who want a lightweight approach to using SaltStack. With this tool, you can run a single SLS file on your local machine without setting up the more extensive master or minion infrastructure. Whether you’re testing a new SLS or need a quick execution, salt-sls is your friend.
What is POP?
This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.
For more information:
Getting Started
Prerequisites
Python 3.8+
git (if installing from source, or contributing to the project)
Installation
If wanting to use salt-sls, you can do so by either installing from PyPI or from source.
Install from PyPI
pip install salt-sls
Install from source
# clone repo
git clone git@vmware/pop/salt-sls.git
cd salt-sls
# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install .
Usage
Examples
To run your SLS files, you can use either the standard Python command or the convenient sls command. You can also set specific configuration options through a my_config.yaml file.
Using the standard Python command in the cloned repo:
python run.py examples/test.sls
Or using the sls command from pypi:
echo "test:\n test.nop:\n - name: state" > test.sls
sls test.sls
Configuration
Set up configuration options for salt-sls through a my_config.yaml file. Here’s an example:
# my_config.yaml
salt_sls:
cachedir: /var/log/salt
# Add any minion config opts you want to use under the "minion_opts" key.
# Refer to the [official minion config documentation](https://docs.saltproject.io/en/latest/ref/configuration/minion.html) for details.
minion_opts: {}
Roadmap
Reference the open issues for a list of proposed features (and known issues).
Acknowledgements
Img Shields for making repository badges easy.
Release files for salt-sls 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| salt-sls-1.0.1.tar.gz | 8.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| salt_sls-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.7 kB
Release files / salt-sls-1.0.1.tar.gz
| Download URL | salt-sls-1.0.1.tar.gz |
|---|---|
| Size | 8.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8f305ccf0073d6fbe8f5f485ae9765e8569ff124e83ae163982a95f41947f135
|
|
BLAKE2b-256 checksum How to use checksums |
8aa24efe611b9a8ed696e794115d924dd7dacb90d0f8125f0753300ae1008d97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.9.6 readme-renderer/41.0 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.4 tqdm/4.66.1 importlib-metadata/6.8.0 keyring/24.2.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.18
|
Release files / salt_sls-1.0.1-py3-none-any.whl
| Download URL | salt_sls-1.0.1-py3-none-any.whl |
|---|---|
| Size | 9.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
10134999fd37c8bd399ee5e4722649900b88863e69c8957f865bd4572cf1eaf7
|
|
BLAKE2b-256 checksum How to use checksums |
d3e0b6446ec427cd42ea3afee4fa23cd096262d3a14ec4c31b25a758a37d0da3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.9.6 readme-renderer/41.0 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.4 tqdm/4.66.1 importlib-metadata/6.8.0 keyring/24.2.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.18
|