Ansible Role User Formation

Role For create users on Linux Server, this role is only use for formation pupose, do not use it in production environnement

Requirements

• Ansible user module

Creating users

Add a users variable containing the list of users to add. A good place to put this is in group_vars/all or group_vars/groupname if you only want the users to be on certain machines.

The following attributes are required for each user:

• username - The user's username.
• name - The full name of the user (gecos field).
• home - The home directory of the user to create (optional, defaults to /home/username).
• uid - The numeric user id for the user (optional). This is required for uid consistency across systems.
• gid - The numeric group id for the group (optional). Otherwise, the uid will be used.
• password - If a hash is provided then that will be used, but otherwise the account will be locked.
• update_password - This can be either 'always' or 'on_create'
  • 'always' will update passwords if they differ. (default)
  • 'on_create' will only set the password for newly created users.
• group - Optional primary group override.
• groups - A list of supplementary groups for the user.
• append - If yes, will only add groups, not set them to just the list in groups (optional).
• profile - A string block for setting custom shell profiles.
• ssh_key - This should be a list of SSH keys for the user (optional). Each SSH key should be included directly and should have no newlines.
• generate_ssh_key - Whether to generate a SSH key for the user (optional, defaults to no).

In addition, the following items are optional for each user:

• shell - The user's shell. This defaults to /bin/bash. The default is configurable using the users_default_shell variable if you want to give all users the same shell, but it is different than /bin/bash.

Example:

    ---
    users:
      - username: foo
        name: Foo Barrington
        groups: ['wheel','systemd-journal']
        uid: 1001
        home: /local/home/foo
        profile: |
          alias ll='ls -lah'
        ssh_key:
          - "ssh-rsa AAAAA.... foo@machine"
          - "ssh-rsa AAAAB.... foo2@machine"
    groups_to_create:
      - name: developers
        gid: 10000
    users_deleted:
      - username: bar
        name: Bar User
        uid: 1002

Dependencies

None.

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

    - hosts: servers
      roles:
         - { role: username.rolename, x: 42 }

License

BSD

Author Information

christophepiv@gmail.com trololo.com