Salt Extension for Heist

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

Security

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

Contributing

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 https://github.com/saltstack/salt-ext-heist.git

# 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/tests.in -r requirements/base.txt -r requirements/docs.in

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

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# 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:

• Documentation - especially examples of how to use this module to solve specific problems.
• Triaging issues and participating in discussions
• Reviewing Pull Requests (we really like Conventional Comments!)

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.