userfacts

pdk
Facts related to *nix and windows system users

Puppet-Finland team

puppetfinland

4,363 downloads

4,322 latest version

5.0 quality score

Version information

  • 1.0.2 (latest)
  • 1.0.1
released May 3rd 2018
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0
  • CentOS
    ,
    Debian
    ,
    RedHat
    ,
    Ubuntu
    , windows

Start using this module

Documentation

puppetfinland/userfacts — version 1.0.2 May 3rd 2018

userfacts

This module contains custom facts about system users. Separate variants are available for *NIX-like operating systems and Windows. The only caveat is that the UID range used by the facts on *NIX systems may be Linux-specific (1000-60000).

Usage

This module currently creates a fact for each local *NIX system user in the user__is_present format. For example, if users "john" and "jane" are present then two facts are created:

  • user_john_is_present: true
  • user_jane_is_present: true

On windows users the format is winuser_<username_is_present. Note that in Windows these outputs are strings. In your puppet module you must use them something like this:

$users = ['john', 'jane']

$users.each | $user | {

   if $facts["winuser_${user}_is_present"] != 'true' {
      user { "${user}":
           ensure     => present,
           name       => $user,
           comment    => $user,
           groups     => [ 'Users' ],
           password   => '************',
           managehome => true,
      }
   }
}

All of these facts automatically resolve to true. They are useful for figuring out on which servers a user is present, especially when there are users not managed by Puppet.