Skip to main content
Made with pop, a Python implementation of Plugin Oriented Programming Made with Python

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

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)

Source distribution for salt-sls 1.0.1
File Size Uploaded
salt-sls-1.0.1.tar.gz 8.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for salt-sls 1.0.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page