soluble
Soluble is a tool for setting up, managing, and tearing down ephemeral Salt minions on remote systems u sing a streamlined Python-based approach. It simplifies the deployment of temporary nodes that can execute Salt commands and clean up afterward, making it ideal for transient infrastructure needs.
About
Soluble is designed aims to streamline the deployment of ephemeral nodes with Salt leveraging salt-ssh for setting up and tearing down temporary Salt minions, allowing users to execute Salt commands on these minions before safely removing them. The entire process is managed by a Python script, ensuring ease of use, flexibility, and integration with existing Python-based infrastructure.
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.10+
git (if installing from source, or contributing to the project)
SaltStack installed on the master node
salt and salt-key commands available
Installation
If wanting to use soluble, you can do so by either installing from PyPI or from source.
Install from PyPI
If package is available via PyPI, include the directions.
pip install soluble
Install from source
# clone repo
git clone git@<your-project-path>/soluble.git
cd soluble
# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Usage
Soluble is designed to simplify the process of setting up ephemeral Salt minions, running commands, and then cleaning up those minions. Here’s a basic usage example:
# Example usage of soluble.py
soluble -R /path/to/roster 'test.ping'
In this example: - The -R flag specifies the path to the roster file for salt-ssh. - The first positional argument (test.ping) is the Salt command to be executed on the ephemeral minions.
Examples
Here are a few more examples of how you can use Soluble:
# Install a package on ephemeral nodes
soluble minion '*' 'pkg.install vim'
# Apply a state file
soluble '*' 'state.apply my_state'
# Ping minions
soluble minion '*' 'test.ping'
Roadmap
Reference the open issues for a list of proposed features (and known issues).
The project roadmap includes: - Expanding support for additional Salt modules and functions. - Enhancing error handling and logging for more robust operation. - Integration with other infrastructure management tools.
Acknowledgements
Img Shields for making repository badges easy.
Metadata
Release files for soluble 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| soluble-3.0.0.tar.gz | 10.2 kB | Without provenance | Details for soluble-3.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| soluble-3.0.0-py3-none-any.whl | Python 3 | none | any | Details for soluble-3.0.0-py3-none-any.whl |
Total release size: 15.8 kB
Release files / soluble-3.0.0.tar.gz
| Download URL | soluble-3.0.0.tar.gz |
|---|---|
| Size | 10.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c541f9e573b2f7c7b03985f80e08bdf86c44631f6a8a6a6b3df38413025c4050
|
|
BLAKE2b-256 checksum How to use checksums |
19b12b1d3f68bd28defb8e373061902dda2ca2c4a54a742c553c4b3c303d87fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.0rc1
|
Release files / soluble-3.0.0-py3-none-any.whl
| Download URL | soluble-3.0.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a8cf392c0cdc9a15a05403cee469d999dc2091c99f98fb9aa077ea20514daa0f
|
|
BLAKE2b-256 checksum How to use checksums |
ca97ca678b92e1ad83b615c4349f801b60672eb214ffb6fc4c1074d3a5254314
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.11.0rc1
|
Security for soluble 3.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.