Skip to main content

Salt Extension for Heist and Heist Salt

Project description

Salt Extension for Heist

This is a collection of Salt-maintained extension modules for use with Heist and Heist-Salt.


If you think you've found a security vulnerability, see Salt's security guide.


The salt-ext-heist project team welcomes contributions from the community. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ.

The Salt Contributing guide has a lot of relevant information, but if you'd like to jump right in here's how to get started:

# Clone the repo
git clone --origin salt

# Change to the repo dir
cd salt-ext-heist

# Create a new venv
python3 -m venv env --prompt heist-ext
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# Install extension + test/doc dependencies into your environment
python -m pip install -e . -r requirements/ -r requirements/base.txt -r requirements/

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)

For code contributions, as part of VMware we require a signed CLA. If you've already signed the VMware CLA, you're probably good to go.

Of course, writing code isn't the only way to contribute! We value contributions in any of these areas:

You could also contribute in other ways:

  • Writing blog posts
  • Posting on social media about how you used Salt+Heist to solve your problems, including videos
  • Giving talks at conferences
  • Publishing videos
  • Asking/answering questions in IRC, Slack, or email groups

Any of these things are super valuable to our community, and we sincerely appreciate every contribution!

For more information, build the docs and head over to http://localhost:8000/ — that's where you'll find the rest of the documentation.

How to use the Heist Salt Extension

# Distribute the Salt artifact to the target
salt-run heist.deploy salt.minion

This starts up the Heist-Salt process, copies the artifact and initiates the SSH tunnel between the Master and Minion. Once you run this command you can interact with the Heist Minions. If you run salt-key you will see the new key for the host you targeted and you can run Salt commands for the new minion.

You can read the Heist or Heist Salt docs to learn more about the projects.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

saltext.heist-1.0.0b0.tar.gz (35.7 kB view hashes)

Uploaded Source

Built Distribution

saltext.heist-1.0.0b0-py2.py3-none-any.whl (11.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page