user_group

Convenience module to create users and groups

YO61 Limited

yo61

11,991 downloads

9,524 latest version

4.6 quality score

Version information

  • 0.2.6 (latest)
  • 0.2.5
  • 0.2.4
  • 0.2.3
  • 0.2.2
  • 0.2.1
  • 0.2.0
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Jul 6th 2015
This version is compatible with:
  • CentOS
    ,
    Debian
    ,
    OracleLinux
    ,
    RedHat
    ,
    Scientific
    ,
    Ubuntu

Start using this module

Tags: user, group

Documentation

yo61/user_group — version 0.2.6 Jul 6th 2015

####Table of Contents

  1. Overview - What is the user_group module?
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with user_group
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

##Overview

A simple wrapper to aid the creation of users/groups.

##Module Description

This module is a convenience wrapper around the native puppet user and group resource types to make it easy to create a user with a group having the same name and id.

##Setup

###What user_group affects

The user_group define creates users/groups.

###Beginning with user_group

To create a new user and a group with the same name:

  user_group{'my_user':}

##Usage

###Classes and Defined Types

####Defined Type: user_group

Creates a user and (by default) a group with the same name.

  user_group{'my_user':}

Parameters within user_group: #####ensure #####create_group #####create_user #####gname #####allowdupe #####comment #####gid #####groups #####home #####managehome #####password #####password_max_age #####purge_ssh_keys #####shell #####system #####uid

##Reference

###Classes

####Public Classes

There are no public classes in this module.

####Private Classes

  • user_group::params: defines OS-specific defaults

###Defined Types

####Public Defined Types

  • user_group: Creates a user and a group with the same name

##Limitations

This module should work on all platforms supported by puppet but has not been tested on anything other than CentOS 7.

##Development

Feel free to improve anything.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request