SaltStack Config provides several default targets and jobs along with supporting files and pillar data. Sample job files and pillar data are placed in the sse Salt environment so they don’t interfere with files and pillar data in the base environment. The sample content includes targets, jobs, pillar data, and supporting files.
To test the basic functionality of SaltStack Config, try working with some sample content in the user interface. You may need to install the Salt minion service on a few of the nodes you want to manage before trying the sample content.
Sample job files and pillar data are placed in the
sse Salt environment so they don’t interfere with files and pillar data in the
base environment. See Environments for more information.
A target is the group of minions, across one or many Salt masters, that a job’s Salt command applies to. A Salt master can also be managed like a minion and can be a target if it is running the minion service. See Minions for more information.
Jobs are used to run remote execution tasks, apply states, and start Salt runners. See Jobs for more information.
Files in SaltStack Config are useful for configuring states you can then apply through jobs. Files are stored in the file server. The file server is a location for storing both Salt-specific files, such as top files or state files, as well as files that can be distributed to minions, such as system configuration files. See File Server for more information.
Pillars are structures of data defined on the Salt master and passed through to one or more minions, using targets. They allow confidential, targeted data to be securely sent only to the relevant minion. See Pillars for more information.
How to use SaltStack Config samples
Samples are used to save time setting up your SaltStack Config environment. With default jobs, you can take advantage of predefined state files and pillar data to begin running frequently-used operations.
You might also refer to samples as a model for how different system elements are configured to work together as you build your own workflows.
SaltStack Config includes a range of default target groups containing all minions of a given operating system. The following default targets are defined by matching the
- Windows Servers
See Minions for more information.
SaltStack Config provides various state and remote execution jobs. Each is described in further detail below, with a description of related files and pillars where applicable.
Enables more accurate presence detection. Presence indicates if SaltStack Config has received any job data from the minion recently, within a defined interval. See Minion presence for more information.
state.highstate on targeted minions. A highstate is a state module that applies all states configured in the
top.sls must be user-defined and is not included as a sample file. See Jobs for more information.
Installs Apache. This state contains logic to determine the correct name of the Apache package based on the target OS.
Sample Disk Usage
disk.usage command on targeted minions.
- PHP, Apache
- pillar customization
dokuwiki_url: sets the URL path where the wiki should appear, default
wiki_title: sets the wiki title, default
Sample HTOP install
Sample HTOP remove
Sample LAMP stack
- mySQL, PHP, Apache
- pillar customization
Installs Apache, mySQL, and PHP.
Sample refresh pillar
Refreshes the Salt pillar on targeted minions. Run this after assigning pillar data to minions.
test.ping command on targeted minions.