Salt/users-formula

Go to file

Simon Lloyd 60e94564d1 Don't add sudo group by default. This formula doesn't really require the sudo group (unless there are actually users in that group). Moreover, on FreeBSD the 'admin' group would be wheel and not sudo.		2015-08-13 23:57:09 +02:00
users	Don't add sudo group by default.	2015-08-13 23:57:09 +02:00
LICENSE	Removing extra new line characters	2015-05-07 13:39:04 -04:00
README.rst	Add support for .profile file	2015-08-09 13:59:51 -03:00
pillar.example	Add support for .profile file	2015-08-09 13:59:51 -03:00

README.rst

=====
users
=====

Formula to configure users via pillar.


.. note::

    See the full `Salt Formulas installation and usage instructions
    <http://docs.saltstack.com/topics/development/conventions/formulas.html>`_.

Available states
================

.. contents::
    :local:

``users``
---------

Configure a user's home directory, group, the user itself, secondary groups,
and associated keys. Also configures sudo access, and absent users.

``users.sudo``
--------------

Ensures the sudo group exists, the sudo package is installed and the sudo file
is configured.

``users.bashrc``
----------------

Ensures the bashrc file exists in the users home directory. Set manage_bashrc:
True in pillar per user. Defaults to False

``users.profile``
----------------

Ensures the profile file exists in the users home directory. Set manage_profile:
True in pillar per user. Defaults to False

``users.vimrc``
---------------

Ensures the vimrc file exists in the users home directory. Set manage_vimrc:
True in pillar per user. Defaults to False
This depends on the vim-formula to be installed