salt-test-lab

Used to create a test lab that can be used to work with MOSE and Salt.

Warning, take heed: This lab should be run in a controlled environment; it contains vulnerable assets.

Table of Contents

• Dependencies
• Basic Lab Build Instructions
• Extended Lab Build Instructions
• Credits
• Developer Documentation

---

Dependencies

You must download and install the following for this environment to work:

• Docker
• Docker Compose
• Latest release of the salt-test-lab binary

Basic Lab Build Instructions

To create an environment with a salt master that controls a single minion with a simple hello world module, run the following command:

# If your host OS is Linux
salt-test-lab-linux-amd64 buildBasic
# If your host OS is MacOS
salt-test-lab-darwin-amd64 buildBasic

To tear down the lab, run the following command:

# If your host OS is Linux
salt-test-lab-linux-amd64 destroyBasic
# If your host OS is MacOS
salt-test-lab-darwin-amd64 destroyBasic

Extended Lab Build Instructions

To create an environment with a salt master that controls multiple minions with multiple environments and includes a database, web server, and development system:

# If your host OS is Linux
salt-test-lab-linux-amd64 buildExtended
# If your host OS is MacOS
salt-test-lab-darwin-amd64 buildExtended

Please note: The docker labs do not support transferring payloads to the target via the web server. You can however generate a payload with the -f parameter and transfer it via docker cp.

To tear down the lab, run the following command:

# If your host OS is Linux
salt-test-lab-linux-amd64 destroyExtended
# If your host OS is MacOS
salt-test-lab-darwin-amd64 destroyExtended

Credits

This article was a critical component in standing up this lab.