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
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.