- Jinja 46.7%
- Shell 38.5%
- Just 14.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
e0e52b8331
Root runs the borgmatic script, and the container (running as root with CAP_DAC_OVERRIDE) reads the configuration, so its hooks would run as root. Whoever owns the base path could rename the other paths (even root-owned ones) and put others in their place. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
| .github | ||
| bin | ||
| defaults | ||
| docs | ||
| LICENSES | ||
| meta | ||
| molecule | ||
| tasks | ||
| templates | ||
| .ansible-lint | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .python-version | ||
| .yamllint.yml | ||
| justfile | ||
| LICENSE | ||
| mise.toml | ||
| README.md | ||
| REUSE.toml | ||
BorgBackup Ansible role
This is an Ansible role which installs and configures BorgBackup (short: Borg) with borgmatic in a Docker container wrapped in a systemd service.
This role implicitly depends on:
Check defaults/main.yml for the full list of supported options. Refer to this page for details about setting up the service with this role.
💡 For an Ansible playbook which integrates this role and makes it easier to use, see the Mother-of-All-Self-Hosting Ansible playbook.
Development
pre-commit
You can optionally install a Git pre-commit hook (via mise + prek) that runs formatting and linting checks before each commit. See .pre-commit-config.yaml for which hooks are to be executed.
To install the hook, run the just command below:
just prek-install-git-pre-commit-hook
Molecule
This role supports Molecule, an Ansible testing framework designed for developing and testing Ansible collections, playbooks, and roles.
Refer to this page for details about how to utilize it.
Releases
Tags are created on the GitHub workflow by .github/workflows/autotag.yml, which asks bin/compute-next-tag.sh what the commit on main should be released as. The answer comes from the version pinned in defaults/main.yml and from the tags that already exist, so a commit that only touches documentation or CI is not released at all, and any change to the role itself is — without waiting for a dependency bump to carry it along.
bin/test-compute-next-tag.sh exercises that script against throwaway repositories, and runs as a prek hook.