A SaltStack formula to manage system users and groups.
Table of Contents
See the full SaltStack Formulas installation and usage instructions.
If you are interested in writing or contributing to formulas, please pay attention to the Writing Formula Section.
Configures users' home directory, group, shell, the user itself, secondary groups.
It also manages per-user SSH authorized_keys files. Two possibilities:
- indicate a ssh_pubkey.source pillar for a user
- indicate a global config.ssh_pubkeys_dir value
The formula will first look for a per-user value and, if it doesn't exist, search for a {{ user }}.pub file in the config.ssh_pubkeys_dir if it exists. You can also indicate that a user have no ssh pubkey.
You can also manage user files. Files management can be enabled or disabled globally or per-user. The source files can be defined globally, each user will take the directory with its username. Source can also be defined per-user. A default source can be defined and be used if no per-user source is found.
All configuration is made using pillar data, read pillar.example to see how.
Linux testing is done with kitchen-salt.
Creates the docker instance and runs the usersandgroups main state, ready for testing.
Runs the inspec tests on the actual instance.
Removes the docker instance.
Runs all of the stages above in one go: i.e. destroy + converge + verify + destroy.
Gives you SSH access to the instance for manual testing.