Default variable details
Some of debops.persistent_paths
default variables have more extensive
configuration than simple strings or lists, here you can find documentation and
examples for them.
persistent_paths__paths
persistent_paths__paths
and similar dictionary variables
can be used to manage the persistence of paths.
The dictionary key should be used to bundle different paths together which are needed to achieve one goal.
This allows to mask/overwrite them later in the hierarchy as defined by persistent_paths__combined_paths
.
For use as dependency role, the key should be {{ weight }}_{{ role_owner }}_{{ role_name }}{{ optional_tags }}
where weight
should be a two-digit number. For DebOps roles, the weight 50
should be used.
For direct use, the key could be 70_local_mlocate
for example.
Each dictionary value is a dictionary by itself with the following supported options:
paths
Required, list of strings. Paths to make persistent. The same path can be required to be persistent by multiple parties.
state
Optional, string. Defaults to
present
. Options:present
The paths should be persistent.
absent
The paths are not required to be persistent. A possibly existing persistent state is not removed by this. Note that other parties might still require paths to be persistent which is not effected by setting one entry to
absent
.
by_role
Optional, string. Name of the Ansible role in the format
{{ role_owner }}.{{ role_name }}
which is responsable for the entry. This option probably only makes sense in the use as dependency role.
Examples
---
persistent_paths__dependent_paths:
'50_debops_cryptsetup':
by_role: 'debops.cryptsetup'
paths:
- '/etc/fstab'
- '/etc/crypttab'
- '/var/local/keyfiles'
- '/var/backups/luks_header_backup'
- '/media'
persistent_paths__group_paths:
'70_local_mlocate':
paths:
- '/var/lib/mlocate'