gitlab-mirror/roles/users/README.md

users

Create user accounts according to a YAML manifest.

Controls:

• username and UID
• groupname and GID
• homedir creation
• GECOS field (typically full user name)
• shell
• SSH public key deployment to .ssh/authorized_keys
• account expiration
• memory, swap and CPU allocation limits via user slices

Check out corvus-migratorius/ansible-disk-quotas for controlling non-root filesystem quotas.

Requirements

Target node:

• systemd
• openssh client library

Controller:

• passlib (for working with user passwords)

Role Variables

manifest_path: a YAML file containing user definitions (see molecule/default/users.yml for an example)

users: a list of objects mirroring the YAML structure expected by manifest_path; takes precedence over it

common_memory_max: e.g. "500M", optional

common_swap_max: e.g. "2G", optional

common_cpu_quota: e.g. "100%", optional

Dependencies

Example Playbook

• Configuring users in a YAML manifest: converge.yml
• Configuring user list as a variable: converge.yml

License

BSD

Author Information

corvus-migratorius@proton.me sayganova@genlab.llc