https://github.com/rohit01/zero-users

Zero hassle Linux user management. Built with ♥ and Ansible
https://github.com/rohit01/zero-users

Last synced: 18 days ago
JSON representation

Zero hassle Linux user management. Built with ♥ and Ansible

• Host: GitHub
• URL: https://github.com/rohit01/zero-users
• Owner: rohit01
• License: gpl-3.0
• Created: 2014-08-16T18:43:43.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-09-11T12:15:47.000Z (over 10 years ago)
• Last Synced: 2023-03-23T22:40:07.114Z (almost 2 years ago)
• Homepage: http://rohit.io
• Size: 230 KB
• Stars: 28
• Watchers: 3
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
zero-users: Zero hassle user management

=======================================

zero-users is an ansible project to perform linux user management with minimum configuration with built in validation. Users, created using zero-users, can ssh into servers using key based authentication.

Prerequisites

=============

[Ansible](http://www.ansible.com): A working installation of ansible is required. See installation details [here](http://docs.ansible.com/intro_installation.html).

Features

========

* Automated user creation, deletion on configurable server groups

* Sudo access management

* Builtin configuration validation

Instructions

============

* **Note**: The documentation is divided into multiple files and directory. Configuration files & directories may contain useful info specific to the area. Please check for README.md file at configuration directories and comments in variable files before making changes.

* **Configure**:

    1. Define servers in an ansible inventory file. See examples in the [inventory/](inventory/) directory

    2. Define users, sudo access permission in the variable file [here](roles/zero_users/vars/)

    3. Place the users ssh public key [here](roles/zero_users/files/public_keys/)

* **Execute**:

```bash

    $ ansible-playbook -v -i inventory/production.ini site.yml

```

Extra Arguments

===============

* **validate_mode**: When *validate_mode* is passed as true, the playbook does configuration validation and skips all real tasks. Default: False. Sample execution:

```bash

    $ ansible-playbook -v -i inventory/production.ini -e validate_mode=true site.yml

```

* **remove_home**: When *remove_home* is passed as true, the home directory of users being deleted is also deleted. Default: False. Sample execution:

```bash

    $ ansible-playbook -v -i inventory/production.ini -e remove_home=true site.yml

```