ansible.users's Introduction

Ansible Role: users

Important Update

Please note that the ansible.users role has been moved to a new collection and will no longer be actively developed in this repository. For the latest version of the role, including new features and updates, please visit the new collection at https://github.com/arillso/ansible.system/tree/main/roles/users. We encourage all users to switch to the updated role in the new collection for ongoing support and improvements.

Description

This is an Ansible role which users and user's authorized keys manages on Linux and Windows.

Installation

ansible-galaxy install arillso.users

Requirements

None

Role Variables

Users

list of users to add

users: []

 list of users to add by host vars
users_list_host: []

list of users to add by group vars

users_list_group: []

Example

 users:
   - username: foobar              (required)
     name: Foo Bar
     uid: 1000
     group: staff
     password: xxxxx               (a hash created with: mkpasswd)
     groups: ["adm", "www-data"]
     append: no                    (only append groups, leave others)
     home_mode: "0750"
     home_create: yes
     home: /path/to/user/home
     system: no
     authorized_keys: []
     authorized_keys_exclusive: yes
     ssh_key_type: rsa
     ssh_key_bits: 2048
     ssh_key_password: ""
     ssh_key_generate: no
     ssh_key: "xxx"
     shell: /bin/bash
     update_password: always

users:
  - username: foobar              (required)
    name: Foo Bar
    description: User
    password: xxxxx
    groups: ['adm', 'www-data']
    hide: true

users home directory

users_home: /home

default user's primary group for users

users_group:

default user's secondary groups

users_groups: []

default user's home directory permissions

users_home_mode: '0755'

default user's ssh key type

users_ssh_key_type: rsa

default user's ssh key bits

users_ssh_key_bits: 2048

default user's setting for authorized keys exclusive

users_authorized_keys_exclusive: 'no'

Dependencies

None

Example Playbook

- hosts: all
  roles:
    - arillso.users

Author

Simon Bärlocher

Inspiration

We Are Interactive

License

This project is under the MIT License. See the LICENSE file for the full license text.

Copyright

ansible.users's People

Contributors

Stargazers

Watchers

ansible.users's Issues

`users_list_group` and `users_list_group` are documented but not used (still using `users_group_vars` and `users_host_vars`)

Ansible var users_list_group and users_list_group are documented documented in as list of user and exists as default, but is never used in role. According to CHANGELOG.md:

change var users_host_vars to users_list_host
change var users_group_vars to users_list_group

However related PR left old variables intact in tasks despite changing default and README

Recommend Projects

arillso / ansible.users Goto Github PK