https://github.com/anxs/generic-users

Ansible role for managing user accounts. Includes a module to help generate the user var structure.
https://github.com/anxs/generic-users

ansible ansible-modules ansible-role sysadmin

Last synced: 3 days ago
JSON representation

Ansible role for managing user accounts. Includes a module to help generate the user var structure.

• Host: GitHub
• URL: https://github.com/anxs/generic-users
• Owner: ANXS
• License: mit
• Created: 2014-03-15T07:51:03.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-09-18T03:20:23.000Z (about 2 months ago)
• Last Synced: 2024-09-18T06:37:05.241Z (about 2 months ago)
• Topics: ansible, ansible-modules, ansible-role, sysadmin
• Language: Python
• Homepage:
• Size: 26.4 KB
• Stars: 30
• Watchers: 8
• Forks: 15
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## ANXS - generic-users [![Build Status](https://travis-ci.org/ANXS/generic-users.png)](https://travis-ci.org/ANXS/generic-users)

Ansible role which manages the groups and user accounts.

#### Requirements & Dependencies

- Tested on Ansible 1.8 or higher.

#### Variables

```yaml

genericusers_groups:

  - name: "dbadmins"

    gid: 5000           # (Optional)

    system: no          # (Optional)

  - name: "mailadmins"

    gid: 6000

    system: no

genericusers_groups_removed:

  - name: "defunctadmins"

genericusers_users:

  - name: "foo"

    groups: ["admin", "staff", "devops"]

    ssh_keys:           # Keys to add to authorized_keys

      - "ssh-dss ......."

      - "ssh-dss ......."

    append: "no"        # (Optional) If yes, will only add groups, not set them to just the list in groups.

    pass: "$6$...."     # (Optional) Set the user's password to this crypted value.

    comment: "foo acc"  # (Optional)

    shell: "/bin/bash"  # (Optional) Set the user's shell.

    home: "/home/baz"   # (Optional) Set the user's home directory.

    system: no          # (Optional) Make the user a system account or not.

  - name: "bar"

    groups: ["admin", "staff", "dev"]

    ssh_keys: []

genericusers_users_removed:

  - name: baz

```

#### Testing

This project comes with a VagrantFile, this is a fast and easy way to test changes to the role, fire it up with `vagrant up`

See [vagrant docs](https://docs.vagrantup.com/v2/) for getting setup with vagrant

#### License

Licensed under the MIT License. See the LICENSE file for details.

#### Feedback, bug-reports, requests, ...

Are [welcome](https://github.com/ANXS/generic-users/issues)!