Salt/users-formula

Go to file

Forrest 0c364461c7 Merge pull request #129 from aboe76/master fix warning on managed file state for /etc/sudoers.d/username		2016-08-30 09:40:20 -07:00
users	fix warning on managed file state for /etc/sudoers.d/username	2016-08-30 17:36:29 +02:00
LICENSE	Removing extra new line characters	2015-05-07 13:39:04 -04:00
README.rst	Fix typos in README.rst	2016-07-28 18:53:32 +02:00
pillar.example	Add example pillar data for optional_groups	2016-08-05 15:04:53 -04: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``
---------

Configures 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. Sets 'manage_bashrc:
True' in pillar per user. Defaults to False.

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

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

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

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

``users.user_files``
---------------

Permits the abitrary management of files. See pillar.example for configuration details.