Default variable details

Some of debops.etckeeper default variables have more extensive configuration than simple strings or lists, here you can find documentation and examples for them.


The etckeeper__*_gitignore variables configure the contents of a section in the /etc/.gitignore file managed by the debops.etckeeper role. This file specifies which paths (directories, files) should be ignored by etckeeper and git. You can check the gitignore(5) manual page for the allowed syntax.

Each entry in the list defined in the variables is a YAML dictionary with specific parameters:

Required. Name of a given entry. If the ignore parameter is not specified, the name parameter is used as-is, otherwise it's not included in the file.
Optional. A string or YAML text block with a comment that describes a given entry.
Optional. String or YAML text block that contains the paths which should be present in the /etc/.gitignore file, it will be added in the file as-is.
Optional. If not specified or present, a given entry will be included in the generated section. If absent, and entry will be removed from the generated section.


Don't include /etc/shadow and /etc/shadow- files in etckeeper repository:


  - name: 'ignore-shadow'
    ignore: |
    comment: "Don't track shadow database"