Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/markahesketh/ansible-role-users
Ansible role for managing system users and groups.
https://github.com/markahesketh/ansible-role-users
ansible-galaxy ansible-role linux provisioning users
Last synced: 3 days ago
JSON representation
Ansible role for managing system users and groups.
- Host: GitHub
- URL: https://github.com/markahesketh/ansible-role-users
- Owner: markahesketh
- License: mit
- Created: 2015-07-25T13:54:15.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-10-26T17:33:26.000Z (about 7 years ago)
- Last Synced: 2024-11-01T23:41:58.459Z (about 2 months ago)
- Topics: ansible-galaxy, ansible-role, linux, provisioning, users
- Homepage: https://galaxy.ansible.com/list#/roles/4485
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ansible Role: Users and Groups
==============================
[](https://travis-ci.org/markahesketh/ansible-role-users)
Ansible role for managing system users and groups.
Installation
------------
```
$ ansible-galaxy install markahesketh.users
```
Role Variables
--------------
All available variables and default values are listed below. You may override these in your Playbook, `group_vars`, command line etc.
```yml
# Default value
users_groups: []
# Available options
users_groups:
- name: "" # Group name
gid "" # (optional) Specify GID
system: no # (optional) Setting to 'yes' makes this user a system group
```
Groups to add / modify on the system. Takes optional parameters from the [Group module](http://docs.ansible.com/ansible/group_module.html).
```yml
# Default value
users_groups_removed: []
```
List of groups to remove from the system.
```yml
# Default value
users_users: []
# Available options
users_users:
- name: "" # Username
authorized_keys: [] # List of file paths to public keys to add to the user's authorized keys list
password: "" # (optional) Password
group: "" # (optional) Sets user's primary group
groups: [] # (optional) Groups to add the user to. Takes a YAML list.
comment: "" # (optional) User's description
home: "" # (optional) User's home directory
shell: "" # (optional) User's shell
uid: "" # (optional) User's UID
system: no # (optional) Setting to 'yes' makes this user a system account
generate_ssh_key: no # (optional) Create an SSH key for this user. Does not override an existing key
```
Users to add / modify on the system. Takes optional parameters from the [Users module](http://docs.ansible.com/ansible/user_module.html).
```yml
# Default value
users_users_removed: []
```
List of users to remove from the system.
Dependencies
------------
None
Example Playbook
----------------
```yml
- hosts: web
roles:
- { role: markahesketh.users }
```
Example Usage
-------------
```yml
users_groups:
- name: "winterfell"
- name: "nightswatch"
- name: "wildlings"
users_groups_removed:
- name: "targaryen"
users_users:
# Robb
- name: "robb"
group: "winterfell"
authorized_keys:
- "files/keys/ned.pub"
- "files/keys/robb-home-pc.pub"
# John
- name: "john"
group: "winterfell"
groups:
- "nightswatch"
- "wildlings"
generate_ssh_key: yes
authorized_keys:
- "files/keys/ned.pub"
- "files/keys/john-work.pub"
users_users_removed:
- name: "ned"
- name: "cat"
```
Author
------
* Web: [markhesketh.co.uk](https://www.markhesketh.co.uk/)
* Email: [[email protected]](mailto:[email protected])
* Twitter: [twitter.com/markahesketh](http://www.twitter.com/markahesketh)
* Github: [github.com/markahesketh](http://www.github.com/markahesketh)
License
-------
Available under the [MIT license](LICENSE).