Getting started

Example inventory

The debops.libuser Ansible role is included by default in the common.yml DebOps playbook; you don't need to do anything to have it executed. It's also included in the bootstrap.yml and the :file:bootstrap-ldap.yml` playbooks to help create the local sysadmin accounts during host bootstrapping.

If you don’t want to let debops.libuser manage user accounts, you can disable it with the following setting in your inventory:

libuser__enabled: False

Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.libuser role:

---

- name: Manage local users and groups
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_all_hosts', 'debops_service_libuser' ]
  become: True

  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'

  roles:

    - role: libuser
      tags: [ 'role::libuser', 'skip::libuser' ]

Ansible tags

You can use Ansible --tags or --skip-tags parameters to limit what tasks are performed during Ansible run. This can be used after host is first configured to speed up playbook execution, when you are sure that most of the configuration has not been changed.

Common role tags:

role::libuser
Main role tag, should be used in the playbook to execute all of the role tasks as well as role dependencies.
skip::libuser
Main role tag, should be used in the playbook to skip all of the role tasks.